Skip to main content

​
安特罗皮克（克劳德）

Anthropic 构建了 Claude 模型系列，并通过 API 提供访问权限。 在 OpenClaw 中，你可以使用 API 密钥或设置令牌进行身份验证。

​
选项A：Anthropic API密钥

最适合： 标准 API 访问和按用量计费。 请在 Anthropic 控制台中创建你的 API 密钥。

​
CLI 设置

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
配置片段 
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } }
}

​
提示缓存（Anthropic API）

除非你显式设置，否则OpenClaw不会覆盖Anthropic的默认缓存TTL。 这仅适用于API；订阅身份验证不遵循TTL设置。 要为每个模型设置 TTL，请在模型的 params 中使用 cacheControlTtl： 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" } // or "1h"
        }
      }
    }
  }
}
OpenClaw为Anthropic API请求引入了extended-cache-ttl-2025-04-11测试标志；如果你想覆盖提供商标头，请保留此标志（参见/gateway/configuration）。

​
选项B：Claude 设置令牌

最适合： 使用你的 Claude 订阅。 获取设置令牌的位置 设置令牌由 Claude Code CLI 创建，而非 Anthropic 控制台。你可以在任何设备上运行以下命令： 
claude setup-token
将令牌粘贴到 OpenClaw 中（向导：Anthropic 令牌（粘贴设置令牌）），或者在网关主机上运行： 
openclaw models auth setup-token --provider anthropic
如果你是在另一台机器上生成的令牌，请将其粘贴： 
openclaw models auth paste-token --provider anthropic

​
CLI 设置

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token
配置片段 
{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } }
}

​
注意事项

故障排除 401 错误 / 令牌突然失效
  • Claude 订阅的身份验证可能会过期或被撤销。请重新运行 claude setup-token，并将结果粘贴到网关主机。
  • 如果 Claude CLI 登录信息保存在另一台机器上，请在网关主机上使用 openclaw models auth paste-token --provider anthropic。
未找到 provider “anthropic” 的 API 密钥
  • 身份验证是按代理划分的。新代理不会继承主代理的密钥。
  • 请为该代理重新运行初始配置流程，或将设置令牌或API密钥粘贴到网关主机，然后使用openclaw models status进行验证。
未找到 profile anthropic:default 的凭据
  • 运行 openclaw models status 查看当前激活的身份验证配置文件。
  • 重新运行初始配置流程，或为该配置文件粘贴设置令牌或 API 密钥。
没有可用的身份验证配置文件（所有配置文件都在冷却中或不可用）
  • 使用 openclaw models status --json 检查 auth.unusableProfiles。
  • 添加另一个 Anthropic 配置文件，或等待冷却期结束。
更多内容请参见 /gateway/troubleshooting 和 /help/faq。