Claude Connect

核心功能与用法

claude-connect 是专为 Clawdbot 用户设计的 OAuth Token 自动管理工具，核心解决 clawdbot onboard 命令的 OAuth 配置缺陷。一键运行 ./install.sh 即可完成：从 macOS Keychain 读取 Claude CLI 凭证 → 写入标准 OAuth 格式 → 配置 launchd 每 2 小时自动刷新。

关键操作路径：
1. 前置依赖：claude auth 完成浏览器登录
2. 安装执行：clawdhub install → ./install.sh 全自动配置
3. 日常管理：./refresh-token.sh --force 强制刷新、tail 查看日志、launchctl 启停定时任务

显著优点

• 精准修复：针对性解决 Clawdbot OAuth auth-profiles 格式写入错误的顽疾
• 安全优先：敏感凭证零明文存储，全程使用 macOS Keychain + HTTPS 官方 API
• 零依赖风险：仅依赖系统内置工具（security/jq/python3/curl），无 npm/pip 供应链攻击面
• 自动化运维：30 分钟缓冲期智能刷新 + Telegram 通知，无需人工干预
• 原子操作：配置文件 temp+rename 写入，避免损坏风险

潜在局限与风险

• 平台锁定：仅支持 macOS（依赖 Keychain 与 launchd）
• T3 来源不确定性：个人开发者维护，长期更新与漏洞响应能力弱于顶级开源基金会
• 持久化进程：安装即注册系统级定时任务，需用户知情同意
• 配置门槛：通知功能需手动填写 Telegram chat ID，引导不足可能造成功能闲置

适合人群

Clawdbot 重度用户、需要 Claude API 稳定长连接的自动化工作流开发者、厌倦手动刷新 Token 的 macOS 用户。

常规风险

• Token 泄露风险：已通过 Keychain 与最小权限设计充分缓释
• 供应链风险：零第三方依赖，静态评分 95/动态 92
• 服务中断风险：Anthropic OAuth 端点变更或 launchd 任务异常（建议定期查看日志）

核心用法

claude-connect 是一款专为 macOS 设计的自动化 OAuth 令牌管理工具，解决 Claude CLI 与 Clawdbot 之间的身份认证衔接问题。

主要功能：

• 一键安装：运行 ./install.sh 自动完成环境检测、配置生成、launchd 定时任务部署
• 密钥链读取：从 macOS Keychain 提取 Claude CLI 存储的 OAuth 令牌
• 格式修复：将令牌写入 Clawdbot 要求的 OAuth 标准格式（解决 clawdbot onboard 的已知 bug）
• 自动续期：每 2 小时自动刷新令牌，避免 8 小时过期中断
• 状态通知：可选 Telegram 通知刷新成功/失败状态

典型工作流：

clawdhub install claude-connect
claude auth  # 确保已登录
./install.sh # 完成全部配置

显著优点

| 维度 | 优势 |

|------|------|

| **零维护** | 安装后无需人工干预，launchd 后台自动运行 |

| **精准修复** | 专门解决 `clawdbot onboard --auth-choice claude-cli` 的 OAuth 格式写入问题 |

| **安全设计** | 仅读取本地 Keychain，不涉及第三方服务器通信 |

| **可观测性** | 完整日志记录 + 可选实时通知 |

| **轻量** | 纯 Shell 脚本实现，无额外依赖 |

潜在缺点与局限性

1. 平台锁定：完全依赖 macOS Keychain 和 launchd，不支持 Linux/Windows
2. 单用户场景：配置硬编码 ~/ 路径，多用户系统需手动调整
3. T3 来源风险：个人开发者维护，长期更新保障存疑
4. 功能单一：仅处理 Claude ↔ Clawdbot 的 OAuth 桥接，无其他认证源支持
5. 通知依赖外部：Telegram 通知需用户自行配置 chat ID，无内置兜底机制

适合人群

• 已订阅 Claude Pro/Team 且使用 Clawdbot 的 macOS 开发者
• 厌倦手动处理 OAuth 令牌过期的自动化爱好者
• 遇到 clawdbot onboard OAuth 配置失败的技术用户

常规风险

• 密钥泄露风险：脚本需要访问 Keychain，虽为本地操作但需用户授予权限
• launchd 任务残留：卸载不彻底可能导致后台任务持续运行
• 上游变更：Anthropic 或 Clawdbot 的 OAuth 流程调整可能导致脚本失效
• 日志增长：长期运行需关注 ~/clawd/logs/ 目录大小，建议配合日志轮转