Anthropic

Anthropic 构建了 Claude 模型家族。OpenClaw 支持两种认证方式：

• API 密钥 — 通过使用量计费直接访问 Anthropic API (anthropic/* 模型)
• Claude CLI — 在同一主机上复用现有的 Claude CLI 登录

Warning

AnthropicOpenClaw 员工告知我们，OpenClaw 风格的 Claude CLI 使用再次获得允许，因此除非 OpenClaw 发布新政策，否则 CLI 将复用 Claude Anthropic 和 claude -p 的使用视为已获批准。

对于长期运行的网关主机，Anthropic API 仍然是最清晰且最可预测的生产环境路径。

Anthropic 当前的公开文档：

• Claude Code CLI 参考
• Claude Agent SDK 概述
• 结合 Pro 或 Max 计划使用 Claude Code
• 结合 Team 或 Enterprise 计划使用 Claude Code

入门指南

API 密钥CLIClaude CLI

最适用于： 标准 API 访问和基于使用量的计费。

1. 获取您的 API 密钥

   在 API Console 中创建一个 Anthropic 密钥。

2. 运行新手引导

   openclaw onboard
   # choose: Anthropic API key

   或者直接传入密钥：

   openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

3. 验证模型是否可用

   openclaw models list --provider anthropic

配置示例

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

最佳用于： 重用现有的 Claude CLI 登录信息，而无需单独的 API 密钥。

1. CLI确保 Claude CLI 已安装并已登录

   使用以下命令验证：

   claude --version

2. 运行新手引导

   openclaw onboard
   # choose: Claude CLI
   ```OpenClawCLI
   
   OpenClaw 会检测并重用现有的 Claude CLI 凭据。

3. 验证模型可用

   openclaw models list --provider anthropic
   ```CLICLI

Note

有关 Claude CLI 后端的设置和运行时详细信息，请参阅 CLI 后端。

配置示例

最好使用规范的 Anthropic 模型引用加上 CLI 运行时覆盖：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

出于兼容性原因，传统的 claude-cli/claude-opus-4-7 模型引用仍然有效，但新配置应将提供商/模型选择保持为 anthropic/*AnthropicAPIOpenClawOpenAI，并将执行后端放入提供商/模型运行时策略中。

Tip

如果您希望获得最清晰的计费路径，请改用 Anthropic API 密钥。OpenClaw 还支持来自 OpenAI Codex、Qwen Cloud、MiniMax 和 Z.AI / GLM 的订阅式选项。

思考默认值 (Claude 4.6)

在未设置显式思考级别时，Claude 4.6 模型在 OpenClaw 中默认为 adaptiveOpenClaw 思考模式。

使用 /think:<level> 或在模型参数中覆盖每条消息的设置：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}

Note

相关的 Anthropic 文档：

• 自适应思维
• 扩展思维

提示缓存

OpenClaw 支持 Anthropic 的提示缓存功能，适用于 API 密钥认证。

值	缓存持续时间	描述
"short"（默认）	5 分钟	针对 API 密钥认证自动应用
"long"	1 小时	扩展缓存
"none"	无缓存	禁用提示缓存

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

Per-agent cache overrides

使用模型级参数作为基准，然后通过 agents.list[].params 覆盖特定代理：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } },
    ],
  },
}

配置合并顺序：

1. agents.defaults.models["provider/model"].params
2. agents.list[].params（匹配 id，按键覆盖）

这允许一个代理保持长寿命缓存，而同一模型上的另一个代理为突发/低复用流量禁用缓存。

Bedrock Claude notes

• Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在配置时接受 cacheRetentionAnthropic 透传。
• 非 Anthropic Bedrock 模型在运行时被强制使用 cacheRetention: "none"API。
• API 密钥智能默认值还会在未设置显式值时为 Bedrock 上的 Claude 引用设定 cacheRetention: "short"。

高级配置

Fast mode

OpenClaw 的共享 /fast 切换开关支持直接的 Anthropic 流量（通往 api.anthropic.com 的 API 密钥和 OAuth）。

Command	Maps to
/fast on	service_tier: "auto"
/fast off	service_tier: "standard_only"

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

Note

• 仅针对直接 api.anthropic.com 请求注入。代理路由不会修改 service_tier。
• 显式的 serviceTier 或 service_tier 参数会在两者同时设置时覆盖 /fast。
• 对于没有优先层级容量的账户，service_tier: "auto" 可能会解析为 standard。

Media understanding (image and PDF)

捆绑的 Anthropic 插件注册了图像和 PDF 理解功能。OpenClaw 会根据配置的 Anthropic 身份验证自动解析媒体能力 — 不需要 额外的配置。

Property	Value
Default 模型	claude-opus-4-7
Supported input	Images, PDF documents

当图像或 PDF 附加到对话时，OpenClaw 会自动 通过 Anthropic 媒体理解提供商进行路由。

1M context window (beta)

Anthropic 的 1M 上下文窗口处于 beta 封测状态。请针对每个模型启用它：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

OpenClaw 会将其映射到请求中的 anthropic-beta: context-1m-2025-08-07。

params.context1m: true 也适用于符合条件的 Opus 和 Sonnet CLI 的 Claude CLI 后端 (claude-cli/*)，从而扩展这些 API 会话的运行时 上下文窗口，以匹配直接 Anthropic 的行为。

Warning

需要您的 OpenClaw 凭据具有长上下文访问权限。旧版令牌身份验证 (sk-ant-oat-*) 会被 1M 上下文请求拒绝 —— OpenClaw 会记录警告并回退到标准上下文窗口。

Claude Opus 4.7 1M context

anthropic/claude-opus-4.7 及其 claude-cli 变体默认具有 1M 上下文 窗口 —— 无需 params.context1m: true。

故障排除

401 错误 / 令牌突然失效

Anthropic 令牌认证会过期且可能被撤销。对于新设置，请改用 Anthropic API 密钥。

No API key found for 提供商 "anthropic"

Anthropic 身份验证是针对每个代理 的 —— 新代理不会继承主代理的密钥。请为该代理重新运行新手引导 (或在网关主机上配置 API 密钥)，然后使用 openclaw models status 进行验证。

No credentials found for profile "anthropic:default"

运行 openclaw models status 以查看哪个身份验证配置文件处于活动状态。重新运行新手引导，或为该配置文件路径配置 API 密钥。

No available auth profile (all in cooldown)

检查 openclaw models status --json 获取 auth.unusableProfilesAnthropicAnthropicAnthropic。Anthropic 的速率限制冷却期可能与模型范围有关，因此同级的 Anthropic 模型可能仍然可用。添加另一个 Anthropic 配置文件或等待冷却期结束。

Note

更多帮助：

故障排除

和

常见问题

。

相关

Model selection

选择提供商、模型引用以及故障转移行为。

CLI backends

Claude CLI 后端设置和运行时详情。

Prompt caching

提示缓存如何在各个提供商之间工作。

OAuth and auth

认证详情和凭证重用规则。