​

Anthropic (Claude)

​

选项 A: Anthropic API 密钥

​

CLI 设置

openclaw onboard
# 选择: Anthropic API key

# 或非交互式
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

配置片段

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

​

Prompt 缓存 (Anthropic API)

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" }, // 或 "1h"
        },
      },
    },
  },
}

​

选项 B: Claude setup-token

​

如何获取 setup-token

claude setup-token

openclaw models auth setup-token --provider anthropic

openclaw models auth paste-token --provider anthropic

​

CLI 设置

# 在 onboarding 过程中粘贴 setup-token
openclaw onboard --auth-choice setup-token

​

配置片段

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

​

注意事项

• 使用 claude setup-token 生成 setup-token 并粘贴，或在 gateway 主机上运行 openclaw models auth setup-token。
• 如果你在 Claude 订阅上看到 “OAuth token refresh failed …”，请使用 setup-token 重新认证。参见 /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription。
• 认证详情 + 重用规则参见 /concepts/oauth。

​

故障排除

• Claude 订阅认证可能会过期或被撤销。重新运行 claude setup-token 并将其粘贴到 gateway 主机。
• 如果 Claude CLI 登录在不同的机器上，请在 gateway 主机上使用 openclaw models auth paste-token --provider anthropic。

• 认证是每个 agent独立的。新 agent 不会继承主 agent 的密钥。
• 为该 agent 重新运行 onboarding，或在 gateway 主机上粘贴 setup-token / API 密钥，然后使用 openclaw models status 验证。

• 运行 openclaw models status 查看哪个认证配置文件处于活动状态。
• 重新运行 onboarding，或为该配置文件粘贴 setup-token / API 密钥。

• 检查 openclaw models status --json 中的 auth.unusableProfiles。
• 添加另一个 Anthropic 配置文件或等待冷却期结束。