OAuth

OpenClaw 通过 OAuth 支持提供商的”订阅认证”（特别是 OpenAI Codex (ChatGPT OAuth)）。对?Anthropic 订阅，请使用 setup-token 流程。本页说明：

  • OAuth 令牌交换如何工作（PKCE?
  • 令牌存储**在哪?*（以及为什么）
  • 如何处理多个账户（配?+ 每会话覆盖）

OpenClaw 还支?提供商插?，它们自?OAuth ?API 密钥流程。通过以下方式运行?

openclaw models auth login --provider <id>

令牌接收器（为什么存在）

OAuth 提供商通常在登?刷新流程期间生成新的刷新令牌。某些提供商（或 OAuth 客户端）可能会在同一用户/应用发放新令牌时使旧的刷新令牌失效?

实际症状?

  • 你通过 OpenClaw 和 通过 Claude Code / Codex CLI 登录 ?之后其中之一随机”被注销”

为了减少这种情况，OpenClaw ?auth-profiles.json 视为**令牌接收?*?

  • 运行时从**一个地?*读取凭证
  • 我们可以保留多个配置并以确定性方式路由它?

存储（令牌在哪里?

密钥按代理存储：

  • 认证配置（OAuth + API 密钥 + 可选的值级引用）：~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • 旧版兼容文件：~/.openclaw/agents/<agentId>/agent/auth.json （发现时静?api_key 条目会被清除?

旧版仅导入文件（仍支持，但不是主要存储）?

  • ~/.openclaw/credentials/oauth.json（首次使用时导入?auth-profiles.json?

以上所有内容也尊重 $OPENCLAW_STATE_DIR（状态目录覆盖）。完整参考：/gateway/configuration

有关静态密钥引用和运行时快照激活行为，请参阅密钥管理?

Anthropic setup-token（订阅认证）

在任何机器上运行 claude setup-token，然后粘贴到 OpenClaw?

openclaw models auth setup-token --provider anthropic

如果你在其他地方生成了令牌，请手动粘贴：

openclaw models auth paste-token --provider anthropic

验证?

openclaw models status

OAuth 交换（登录如何工作）

OpenClaw 的交互式登录流程?@mariozechner/pi-ai 中实现，并连接到向导/命令?

Anthropic (Claude Pro/Max) setup-token

流程?

  1. 运行 claude setup-token
  2. 将令牌粘贴到 OpenClaw
  3. 存储为令牌认证配置（无刷新）

向导路径?openclaw onboard ?认证选择 setup-token（Anthropic）?

OpenAI Codex (ChatGPT OAuth)

流程（PKCE）：

  1. 生成 PKCE 验证?挑战 + 随机 state
  2. 打开 https://auth.openai.com/oauth/authorize?...
  3. 尝试?http://127.0.0.1:1455/auth/callback 捕获回调
  4. 如果无法绑定（或你是远程/无头），粘贴重定?URL/代码
  5. ?https://auth.openai.com/oauth/token 交换
  6. 从访问令牌中提取 accountId 并存?{ access, refresh, expires, accountId }

向导路径?openclaw onboard ?认证选择 openai-codex?

刷新 + 过期

配置存储 expires 时间戳?

在运行时?

  • 如果 expires 在未??使用存储的访问令?
  • 如果已过??刷新（在文件锁下）并覆盖存储的凭?

刷新流程是自动的；你通常不需要手动管理令牌?

多个账户（配置）+ 路由

两种模式?

1) 首选：独立代理

如果你希?个人”?工作”永不交互，请使用隔离代理（独立会?+ 凭证 + 工作区）?

openclaw agents add work
openclaw agents add personal

然后为每个代理配置认证（向导）并将聊天路由到正确的代理?

2) 高级：一个代理中的多个配?

auth-profiles.json 支持同一提供商的多个配置 ID?

选择使用哪个配置?

  • 通过配置顺序全局（auth.order?
  • 通过 /model ...@<profileId 每会?

示例（会话覆盖）?

  • /model Opus@anthropic:work

如何查看存在哪些配置 ID?

  • openclaw channels list --json（显?auth[]?

相关文档?