Claude连接助手

技能简介

claude-connect 用于将 Claude CLI 的 OAuth 订阅信息一键接入 Clawdbot，解决 clawdbot onboard 命令在写入 auth-profiles.json 时格式不完整的问题。安装后每2小时自动刷新令牌，保持服务24小时在线。

业务背景

解决Clawdbot接入Claude时的OAuth配置难题。自动修复授权文件格式错误，确保令牌持续有效，避免人工反复登录和手动刷新，让AI助手服务稳定在线不间断。

落地案例：某团队部署Clawdbot后，使用claude-connect完成一次性配置。系统自动从Mac钥匙串读取Claude CLI凭证，按标准格式写入授权文件，并注册后台定时任务每2小时自动续期。成员无需关心令牌过期问题，Clawdbot始终保持与Claude的连通状态。

能做什么

• 从 macOS Keychain 读取 Claude CLI 存储的 OAuth 令牌
• 按标准格式写入 Clawdbot 的 auth-profiles.json
• 每2小时自动调用 Anthropic OAuth API 刷新 access_token 与 refresh_token
• 刷新成功或失败时发送通知（可选 Telegram）
• 修复 onboard 流程中 OAuth 配置未正确生效的故障

使用说明

1. 安装技能

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

2. 确认 Claude CLI 已登录

   claude auth
   # 按提示完成浏览器授权

3. 执行安装脚本

   ./install.sh

   脚本会自动检测 CLI 状态、创建配置文件、注册 launchd 定时任务并执行首次刷新测试。

4. 手动刷新（可选）

   ./refresh-token.sh --force  # 强制立即刷新
   ./refresh-token.sh          # 仅当令牌即将过期时刷新

5. 查看状态

   tail ~/clawd/logs/claude-oauth-refresh.log
   clawdbot models status

输入与输出

见下方输入与输出表格。

风险提示

• 需要 macOS 系统，依赖 Keychain 与 launchd
• 会读写 ~/.clawdbot/agents/main/agent/auth-profiles.json，建议提前备份
• Token 存储于本地 Keychain，请勿将配置文件提交至公共仓库
• 若 launchd 任务被手动卸载，自动刷新将停止，需重新加载 plist 文件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tunaissacoding/claude-connect/SKILL.md
来源类型：GitHub 仓库