核心用法
Clawauth 是一款面向 AI Agent 的 OAuth 授权管理工具，采用「边缘服务发起 → 用户授权 → 本地安全存储」的去中心化架构。其核心流程分为三步：通过 clawauth login start <provider> 生成短链接会话，将授权 URL 推送给用户；Agent 异步继续执行其他任务；后续通过 login status 轮询状态，待用户完成后用 login claim 一次性提取令牌并写入系统密钥链（macOS Keychain、Windows Credential Manager 或 Linux Secret Service）。
显著优点
1. 真正的异步体验：Agent 无需阻塞等待用户授权，适合长会话或中断场景
2. 零持久化令牌托管：刷新令牌仅存本地密钥链，服务端仅保留 1 小时内的临时会话加密 blob
3. 端到端加密：授权回调数据通过 NaCl box 加密，仅目标 CLI 会话可解密
4. 广泛的 SaaS 覆盖：支持 Notion、GitHub、Linear、Slack、Spotify 等 20+ 主流服务
5. 生产级安全设计：签名 state 参数、防重放机制、速率限制、Cloudflare Edge 部署
潜在局限
- 预安装依赖：必须由运维人员预先嵌入可信运行时镜像，不支持动态安装
- CLI 版本锁定：需人工审批和固定版本，升级流程涉及镜像重建
- 轮询开销：异步模式需 Agent 实现状态检查逻辑，增加代码复杂度
- 密钥链可用性：容器或无头环境需额外配置 secretservice 或等效后端
- 服务商风险：虽然令牌不托管，但仍依赖
auth.clawauth.app边缘服务的可用性
适合人群
- 构建长期运行 Agent 系统的开发者（如 Claude Code、Devin 等 AI 编程助手）
- 对第三方令牌 SaaS 托管有合规顾虑的企业安全团队
- 需要跨会话保持授权状态的多轮对话场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 令牌泄露 | `login claim` JSON 输出含敏感数据，禁止记录到日志或聊天 |
| 环境变量污染 | 严禁将令牌导出为 shell 变量，应通过密钥链 API 读取 |
| 会话劫持 | 短链接有效期默认 1 小时，需在 TTL 内完成授权 |
| 供应链攻击 | CLI 二进制必须由可信渠道预装，禁用运行时下载 |
| 密钥链权限 | 首次访问可能触发系统弹窗，需用户交互授权 |