5.7 OAuth认证

OpenClaw 为特定提供商实现 OAuth 认证,为其他提供商使用基于令牌的认证。系统优先考虑安全性和多账户管理。

主要认证方法

Anthropic 订阅

使用设置令牌方式:

# 在任何机器上运行
claude setup-token

# 然后将令牌粘贴到 OpenClaw
openclaw models auth setup-token --provider anthropic

OpenAI Codex

采用基于 PKCE 的 OAuth:

  1. 生成验证器/挑战
  2. 打开授权 URL
  3. 在令牌端点交换凭据

令牌存储架构

凭据按 Agent 组织存储:

# 用户可见的认证配置文件
~/.openclaw/agents/<agentId>/agent/auth-profiles.json

# 运行时缓存
~/.openclaw/agents/<agentId>/agent/auth.json

这种设计防止了同时登录多个应用程序时的令牌失效冲突。

多账户管理

用户可以通过两种策略管理多个账户:

1. 独立 Agent

创建隔离的工作区:

# 添加工作 Agent
openclaw agents add work

# 添加个人 Agent
openclaw agents add personal

2. 配置文件路由

在单个 Agent 内,全局或按会话选择配置文件:

# 使用特定配置文件的模型
/model Opus@anthropic:work

自动令牌刷新

系统监控过期时间戳,并在需要时自动刷新凭据,只需最少的手动干预。

提示
更多 OAuth 认证的详细信息请参考 官方英文文档