OAuth

OAuth 登录：比 API 密钥更简便。Moltbot 对提供该能力的提供商支持「订阅认证」OAuth（ notably OpenAI Codex (ChatGPT OAuth)）。Anthropic 订阅请使用 setup-token 流程。本页涵盖：OAuth 令牌交换（PKCE）、令牌存储位置及原因、多账户（配置与每会话覆盖）处理。

Moltbot 也支持自带 OAuth 或 API 密钥流程的提供商插件。通过以下命令运行：moltbot models auth login --provider <id>。

令牌汇聚（为何存在）

OAuth 提供商常在登录/刷新流程中签发新刷新令牌。部分提供商（或 OAuth 客户端）会在同一用户/应用签发新令牌时使旧刷新令牌失效。表现：你同时在 Moltbot 与 Claude Code / Codex CLI 登录 → 之后其中一个会随机「登出」。为减轻此问题，Moltbot 将 auth-profiles.json 视为令牌汇聚：运行时从单一位置读取凭证；可保留多个配置并确定性路由。

存储（令牌存放位置）

密钥按代理存储：认证配置（OAuth + API 密钥）：~/.clawdbot/agents/<agentId>/agent/auth-profiles.json。运行时缓存（自动管理；请勿编辑）：~/.clawdbot/agents/<agentId>/agent/auth.json。旧版仅导入文件（仍支持，但非主存储）：~/.clawdbot/credentials/oauth.json（首次使用时导入到 auth-profiles.json）。以上路径均受 $CLAWDBOT_STATE_DIR 影响。完整参考：网关配置。

Anthropic setup-token（订阅认证）

在任意机器上运行 claude setup-token，然后将令牌粘贴到 Moltbot：moltbot models auth setup-token --provider anthropic。若在其他地方生成令牌，可手动粘贴：moltbot models auth paste-token --provider anthropic。验证：moltbot models status。

OAuth 交换（登录如何工作）

Moltbot 的交互式登录流程在 @mariozechner/pi-ai 中实现，并接入向导/命令。Anthropic setup-token 流程：运行 claude setup-token → 将令牌粘贴到 Moltbot → 存储为令牌认证配置（无刷新）。更多提供商与多账户说明见英文文档。