Skip to main content
Anthropic 构建了 Claude 模型家族。OpenClaw 支持两种认证方式：
  • API key — Anthropic API 直接访问，按使用量计费（anthropic/* 模型）
  • Claude CLI — 复用同一主机上现有的 Claude Code 登录
OpenClaw 的 Claude CLI 后端会以非交互式打印模式运行已安装的 Claude Code CLI。Anthropic 目前的 Claude Code 文档将 claude -p 描述为 Agent SDK/程序化用法。自 2026 年 6 月 15 日起，Anthropic 表示订阅计划中的 claude -p 使用不再从普通 Claude 订阅额度中扣除；它会先从单独的每月 Agent SDK credit 中扣除，之后在这些 credit 启用时再按标准 API 费率从 usage credits 中扣除。交互式 Claude Code 仍然会从已登录的 Claude 订阅额度中扣除。API key 认证仍然是直接的按量付费 API 计费。对于长期运行的网关主机、共享自动化和可预测的生产支出，请使用 Anthropic API key。Anthropic 当前的公开文档：

​
开始使用

最适合： 标准 API 访问和按使用量计费。
1

获取你的 API key

在 Anthropic 控制台 中创建一个 API key。
2

运行初始化

openclaw onboard
# 选择：Anthropic API key
或直接传入密钥：
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

验证模型可用

openclaw models list --provider anthropic

​
配置示例

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

​
思考默认值（Claude 4.8 和 4.6）

Claude Opus 4.8 在 OpenClaw 中默认关闭思考。 当你显式启用自适应思考并使用 /think high|xhigh|max 时，OpenClaw 会发送 Anthropic 的 Opus 4.8 effort 值；Claude 4.6 模型默认使用 adaptive。 可通过 /think:<level> 按消息覆盖，或在模型参数中设置： 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
相关 Anthropic 文档：

​
提示词缓存

OpenClaw 支持 Anthropic 的提示词缓存功能，适用于 API key 认证。
值缓存时长说明
"short"（默认）5 分钟针对 API key 认证自动应用
"long"1 小时扩展缓存
"none"不缓存禁用提示词缓存
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
先以模型级参数作为基础，再通过 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 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在配置后接受 cacheRetention 透传。
  • 非 Anthropic 的 Bedrock 模型在运行时会被强制设为 cacheRetention: "none"。
  • 当未设置显式值时，API key 智能默认值也会为 Claude-on-Bedrock 引用填入 cacheRetention: "short"。

​
高级配置

OpenClaw 的共享 /fast 开关支持直接 Anthropic 流量（API key 和到 api.anthropic.com 的 OAuth）。
命令映射为
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • 仅对直接 api.anthropic.com 请求注入。代理路由不会改动 service_tier。
  • 当两者都设置时，显式的 serviceTier 或 service_tier 参数会覆盖 /fast。
  • 在没有 Priority Tier 容量的账户上，service_tier: "auto" 可能会解析为 standard。
随附的 Anthropic 插件会注册图片和 PDF 理解能力。OpenClaw 会根据已配置的 Anthropic 认证自动解析媒体能力——无需额外配置。
属性值
Default modelclaude-opus-4-8
Supported inputImages, PDF documents
当图片或 PDF 附加到对话中时，OpenClaw 会自动通过 Anthropic 媒体理解提供方进行路由。
Anthropic 的 1M 上下文窗口可用于具备 GA 能力的 Claude 4.x 模型，例如 Opus 4.8、Opus 4.7、Opus 4.6 和 Sonnet 4.6。OpenClaw 会自动将这些模型的上下文大小设为 1M：
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {},
      },
    },
  },
}
旧配置可以保留 params.context1m: true，但 OpenClaw 不再发送已弃用的 context-1m-2025-08-07 beta 头。旧的 anthropicBeta 配置中带有该值的条目会在请求头解析时被忽略，未受支持的旧 Claude 模型则仍保持其正常上下文窗口。params.context1m: true 也适用于 Claude CLI 后端（claude-cli/*）中符合条件、支持 GA 的 Opus 和 Sonnet 模型，以保留这些 CLI 会话的运行时上下文窗口，使其与直接 API 的行为一致。
需要你的 Anthropic 凭证具备长上下文访问权限。OAuth/订阅令牌认证会保留其所需的 Anthropic beta 头，但如果旧配置中仍保留了已废弃的 1M beta 头，OpenClaw 会将其移除。
anthropic/claude-opus-4-8 及其 claude-cli 变体默认具有 1M 上下文窗口——无需 params.context1m: true。

​
故障排除

Anthropic token 认证会过期，也可能被撤销。对于新配置，建议改用 Anthropic API key。
Anthropic 认证是按代理生效的——新代理不会继承主代理的密钥。请为该代理重新运行初始化（或在网关主机上配置 API key），然后用 openclaw models status 验证。
运行 openclaw models status 查看当前激活的是哪个认证配置文件。重新运行初始化，或为该配置文件路径配置 API key。
检查 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 的速率限制冷却可能是按模型范围生效的，因此同组中的另一个 Anthropic 模型也许仍可使用。添加另一个 Anthropic 配置文件，或等待冷却结束。
更多帮助：故障排除 和 FAQ。

​
相关内容

模型选择

选择提供方、模型引用和故障转移行为。

CLI 后端

Claude CLI 后端的设置和运行时细节。

提示词缓存

提示词缓存如何在各提供方之间工作。

OAuth 和认证

认证细节和凭证复用规则。