claude-connect

只需一步即可将您的Claude订阅连接到Clawdbot。

自动完成：

• ✅ 从钥匙串读取Claude OAuth令牌
• ✅ 以正确的OAuth格式将其写入Clawdbot
• ✅ 每2小时自动刷新（在过期前）
• ✅ 成功/失败时通知您
• ✅ 兼容clawdbot onboard（修复OAuth身份验证配置文件的错误）

快速开始

1. 安装该技能：

clawdhub install claude-connect
cd ~/clawd/skills/claude-connect

2. 确保Claude CLI已登录：

claude auth
# Follow the browser login flow

3. 运行安装程序：

./install.sh

就是这样！令牌将每2小时自动刷新。

功能说明

修复clawdbot onboardOAuth错误

当您运行clawdbot onboard --auth-choice claude-cli时，它有时无法正确地将OAuth令牌写入auth-profiles.json.

此功能：

1. 从 macOS 钥匙串（Claude CLI 存储令牌的位置）读取 OAuth 令牌
2. 将其写入~/.clawdbot/agents/main/agent/auth-profiles.json文件，格式为正确的 OAuth 格式：

   {
     "profiles": {
       "anthropic:claude-cli": {
         "type": "oauth",
         "provider": "anthropic",
         "access": "sk-ant-...",
         "refresh": "sk-ant-ort...",
         "expires": 1234567890
       }
     }
   }
   

3. 设置自动刷新（通过 launchd 每 2 小时运行一次）
4. 保持您的连接 24/7 持续活跃

安装

自动安装（推荐）

cd ~/clawd/skills/claude-connect
./install.sh

安装程序将：

• ✅ 验证 Claude CLI 已设置
• ✅ 创建配置文件
• ✅ 设置自动刷新任务（launchd）
• ✅ 运行首次刷新进行测试

手动安装

1. 复制示例配置：

   cp claude-oauth-refresh-config.example.json claude-oauth-refresh-config.json
   

2. 编辑配置（可选）：

   nano claude-oauth-refresh-config.json
   

3. 测试刷新：

   ./refresh-token.sh --force
   

4. 安装 launchd 任务（可选 - 用于自动刷新）：

   cp com.clawdbot.claude-oauth-refresher.plist ~/Library/LaunchAgents/
   launchctl load ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist
   

配置

编辑claude-oauth-refresh-config.json：

{
  "refresh_buffer_minutes": 30,
  "log_file": "~/clawd/logs/claude-oauth-refresh.log",
  "notifications": {
    "on_success": true,
    "on_failure": true
  },
  "notification_target": "YOUR_CHAT_ID"
}

选项：

• refresh_buffer_minutes：当令牌剩余此分钟数时刷新（默认值：30）
• log_file：刷新活动的日志记录位置
• notifications.on_success：成功刷新时通知（默认值：true）
• notifications.on_failure：失败时通知（默认值：true）
• notification_target：您的Telegram聊天ID（或留空以禁用）

使用说明

手动刷新

# Refresh now (even if not expired)
./refresh-token.sh --force

# Refresh only if needed
./refresh-token.sh

检查状态

# View recent logs
tail ~/clawd/logs/claude-oauth-refresh.log

# Check auth profile
cat ~/.clawdbot/agents/main/agent/auth-profiles.json | jq '.profiles."anthropic:claude-cli"'

# Check Clawdbot status
clawdbot models status

禁用通知

询问Clawdbot：

Disable Claude refresh success notifications

或编辑配置：

{
  "notifications": {
    "on_success": false,
    "on_failure": true
  }
}

工作原理

刷新流程

1. 从钥匙串读取：从以下位置获取OAuth令牌Claude代码凭证
2. 检查有效期：仅在剩余时间少于30分钟时刷新（或--强制）
3. 调用OAuth API：获取新的访问令牌和刷新令牌
4. 更新auth-profiles.json：写入正确的OAuth格式
5. 更新钥匙串：同步新令牌回存
6. 重启网关：获取新令牌
7. 通知：发送成功/失败消息（可选）

自动刷新（launchd）

通过以下方式每2小时运行一次~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist

控制：

# Stop auto-refresh
launchctl unload ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist

# Start auto-refresh
launchctl load ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist

# Check if running
launchctl list | grep claude

故障排除

初始化后OAuth不工作

症状： clawdbot onboard --auth-choice claude-cli命令执行完成但Clawdbot无法使用令牌

修复方法：

cd ~/clawd/skills/claude-connect
./refresh-token.sh --force

这将以正确的OAuth格式写入令牌。

令牌持续过期

症状：8小时后认证持续失败

修复方法：确保launchd任务正在运行：

launchctl load ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist
launchctl list | grep claude

钥匙串中没有令牌

症状： 未找到'Claude Code-credentials'条目

修复方法：使用Claude CLI登录：

claude auth
# Follow browser flow

然后再次运行刷新：

./refresh-token.sh --force

卸载

cd ~/clawd/skills/claude-connect
./uninstall.sh

或手动操作：

# Stop auto-refresh
launchctl unload ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist
rm ~/Library/LaunchAgents/com.clawdbot.claude-oauth-refresher.plist

# Remove skill
rm -rf ~/clawd/skills/claude-connect

升级

如果您之前安装了旧版本：

cd ~/clawd/skills/claude-connect
./validate-update.sh  # Check what changed
clawdhub update claude-connect  # Update to latest
./install.sh  # Re-run installer if needed

另请参阅

• QUICKSTART.md- 60秒设置指南
• UPGRADE.md- 从旧版本升级
• Clawdbot 文档- 模型认证

版本：1.1.0
作者：TunaIssaCoding
许可证：MIT
仓库： https://github.com/TunaIssaCoding/claude-connect