← 返回目录

Anthropic（Claude）

Anthropic 构建了 Claude 模型家族，并通过 API 提供访问。 在 OpenClaw 中，你可以使用 API 密钥或 setup-token 进行身份验证。

选项 A：Anthropic API 密钥

最适合： 标准 API 访问和按使用量计费。 请在 Anthropic Console 中创建你的 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-6" } } },
}

Thinking 默认值（Claude 4.6）

快速模式（Anthropic API）

OpenClaw 的共享 /fast 开关也支持直接 Anthropic API 密钥流量。

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

重要限制：

Prompt 缓存（Anthropic API）

OpenClaw 支持 Anthropic 的 prompt 缓存功能。这仅适用于 API；订阅身份验证不会遵循缓存设置。

配置

在你的模型配置中使用 cacheRetention 参数：

| 值 | 缓存时长 | 说明 | | ------- | -------- | -------------------------- | | none | 不缓存 | 禁用 prompt 缓存 | | short | 5 分钟 | API 密钥身份验证的默认值 | | long | 1 小时 | 扩展缓存（需要 beta 标志） |

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

默认值

当使用 Anthropic API 密钥身份验证时，OpenClaw 会自动对所有 Anthropic 模型应用 cacheRetention: "short"（5 分钟缓存）。你可以通过在配置中显式设置 cacheRetention 来覆盖此行为。

每个智能体的 cacheRetention 覆盖

将模型级参数用作基线，然后通过 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 说明

旧版参数

旧的 cacheControlTtl 参数仍受支持，以保持向后兼容：

我们建议迁移到新的 cacheRetention 参数。

OpenClaw 会在 Anthropic API 请求中包含 extended-cache-ttl-2025-04-11 beta 标志； 如果你覆盖了提供商请求头，请保留它（参见 /gateway/configuration）。

1M 上下文窗口（Anthropic beta）

Anthropic 的 1M 上下文窗口受 beta 门控。在 OpenClaw 中，可通过为受支持的 Opus/Sonnet 模型 设置 params.context1m: true 按模型启用。

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

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

仅当该模型的 params.context1m 被显式设置为 true 时， 此功能才会激活。

要求：Anthropic 必须允许该凭证使用长上下文 （通常是 API 密钥计费，或启用了 Extra Usage 的订阅账户）。 否则 Anthropic 会返回： HTTP 429: rate_limit_error: Extra usage is required for long context requests。

注意：Anthropic 当前在使用 OAuth/订阅令牌（sk-ant-oat-*）时会拒绝 context-1m-* beta 请求。OpenClaw 会自动跳过 OAuth 身份验证的 context1m beta 请求头，并保留所需的 OAuth beta 标志。

选项 B：Claude setup-token

最适合： 使用你的 Claude 订阅。

如何获取 setup-token

setup-token 由 Claude Code CLI 创建，而不是在 Anthropic Console 中创建。你可以在任何机器上运行：

claude setup-token

将该令牌粘贴到 OpenClaw 中（向导：Anthropic token（粘贴 setup-token）），或在 Gateway 网关主机上运行：

openclaw models auth setup-token --provider anthropic

如果你是在另一台机器上生成该令牌，请粘贴它：

openclaw models auth paste-token --provider anthropic

CLI 设置（setup-token）

# Paste a setup-token during setup
openclaw onboard --auth-choice setup-token

配置片段（setup-token）

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

说明

故障排除

401 错误 / 令牌突然无效

No API key found for provider "anthropic"

No credentials found for profile anthropic:default

No available auth profile (all in cooldown/unavailable)

更多信息：/gateway/troubleshooting 和 /help/faq。