Anthropic

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

API 密钥——直接访问 Anthropic API，并按使用量计费（anthropic/* 模型）
Claude CLI——在同一主机上复用现有的 Claude Code 登录。

使用与成本跟踪

OpenClaw 会检测可用的 Anthropic 凭证，并选择匹配的使用界面：

Claude 订阅/设置凭证会显示配额窗口以及可选的额外使用预算。
ANTHROPIC_ADMIN_KEY 或 ANTHROPIC_ADMIN_API_KEY 会在 Control UI 的 Usage 中显示 30 天的提供方报告的组织成本和 Messages API 使用情况，包括每日支出、token/cache 总量、热门模型和成本类别。
存储在 Anthropic 提供方配置文件中的 sk-ant-admin... 凭证会被自动检测为 Admin API 密钥。

Admin API 成本历史来自 Anthropic 的 Usage and Cost API。这是真实的提供方账单，与 OpenClaw 基于会话推导的估算成本是分开的。

OpenClaw 的 Claude CLI 后端会以非交互式打印模式（claude -p）运行已安装的 Claude Code CLI。Anthropic 当前的 Claude Code 文档将该模式描述为 Agent SDK/程序化使用。Anthropic 于 2026 年 6 月 15 日发布的支持更新暂停了此前宣布的独立 Agent SDK 计费变更：Claude Agent SDK、claude -p 以及第三方应用使用仍然会消耗已登录订阅的使用额度，并且此前宣布的每月 Agent SDK 额度在 Anthropic 修改该计划期间不可用。交互式 Claude Code 仍然会消耗已登录 Claude 套餐的额度。 API key 认证则是直接的按量付费计费，不依赖该套餐。对于长期运行的网关主机、共享自动化和可预测的生产支出，请使用 Anthropic API key。Anthropic 当前的支持文章可能会在不发布 OpenClaw 版本的情况下更改此行为：

开始使用

API 密钥
Claude CLI

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

获取你的 API 密钥

在 Anthropic 控制台中创建一个 API 密钥。

运行初始化

openclaw onboard
# 选择：Anthropic API 密钥

或直接传入密钥：

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

验证模型可用

openclaw models list --provider anthropic

配置示例

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

最适合： 复用现有的 Claude CLI 登录，而无需单独的 API 密钥。

确保已安装并登录 Claude CLI

OpenClaw 的流式会话关联要求使用 msg_lifecycle_v1 能力。已知第一个公开声明支持该能力的版本是 Claude Code 2.1.206。请验证已安装的版本：

claude --version

仍然可以选择使用兼容的低版本回移版本或包装器； OpenClaw 会在运行时验证该能力。如果运行时拒绝已安装的版本，请更新 Claude Code 并重启 OpenClaw，以便网关启动新的二进制文件：

claude update

运行初始化

openclaw onboard
# 选择：Claude CLI

OpenClaw 会检测并复用现有的 Claude CLI 凭证。

验证模型可用

openclaw models list --provider anthropic

Claude CLI 后端的设置和运行时详细信息请参阅 CLI 后端。 openclaw doctor 还会针对已安装的 Claude Code 版本低于已知首个兼容版本的情况提供建议。

Claude CLI 复用要求 OpenClaw 进程运行在与 Claude CLI 登录相同的主机上。 Docker 安装可以持久化容器 home，并在其中登录 Claude Code；参见 Docker 中的 Claude CLI 后端。其他容器安装，例如 Podman，不会在设置或运行时将主机的 ~/.claude 挂载进去；请在那里使用 Anthropic API 密钥，或者选择一个由 OpenClaw 管理 OAuth 的提供方，例如 OpenAI Codex。

获取设置令牌

在安装了 Claude Code 的任意机器上运行 claude setup-token。它会打印一个以 sk-ant-oat01- 开头的长期有效令牌。在初始化过程中，在 macOS 应用中选择 使用 API 密钥或令牌连接 下的 Anthropic 设置令牌，然后粘贴令牌；或者使用：

openclaw models auth login --provider anthropic --method setup-token

配置示例

建议使用规范的 Anthropic 模型引用，并通过 CLI 运行时覆盖：

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

旧版 claude-cli/claude-opus-4-7 模型引用仍然可用于兼容性，但新的配置应将提供方/模型选择保持为 anthropic/*，并将执行后端放在 provider/model runtime policy 中。

计费与 `claude -p`

OpenClaw 在 Claude CLI 运行中使用 Claude Code 的非交互式 claude -p 路径。Anthropic 目前将该路径视为 Agent SDK/程序化用法：

Anthropic 在 2026 年 6 月 15 日的支持更新中暂停了先前公布的独立 Agent SDK 积分计划。
订阅计划下的 Claude Agent SDK、claude -p 和第三方应用用量仍会计入已登录订阅的使用额度。
先前公布的每月 Agent SDK 积分在 Anthropic 调整该计划期间不可用。
控制台/API 密钥登录使用按量计费的 API 计费方式，不会获得订阅的 Agent SDK 积分。

有关暂停通知，请参阅 Anthropic 的 Agent SDK 计划文章，有关 Claude Code 计划行为，请参阅 Pro/Max 和 Team/Enterprise 订阅相关文章。Anthropic 可以在不发布 OpenClaw 版本的情况下更改 Claude Code 的计费和速率限制行为。当计费可预测性很重要时，请查看 claude auth status、/status 以及 Anthropic 链接的文档。

对于共享的生产自动化，请使用 Anthropic API 密钥，而不是 Claude CLI。OpenClaw 也支持来自 OpenAI Codex、Qwen Cloud、MiniMax 和 Z.AI / GLM 的订阅式选项。

不同电脑上的 Claude 会话

捆绑的 Anthropic 插件会在普通会话侧边栏中添加一个 Claude Code 分组。各行会在普通聊天面板中打开。它会在 Gateway 以及已连接的节点主机上发现未归档的 Claude Code 会话：

Claude CLI 会话来自有效的项目索引记录。对于未建立索引的转录，受限的元数据回退机制会识别 ~/.claude/projects/ 下并发的非 sidechain 交互式（cli）和无头 Agent SDK CLI（sdk-cli）会话。
当 Claude Desktop 的元数据指向相同的 Claude Code 会话 ID 时，Claude Desktop 会话会使用 Desktop 标题、活动时间和归档状态。
仅限 CLI 的会话没有归档标志，因此只要其转录仍然存在，就会继续显示。

发现过程不需要额外的 OpenClaw 配置。Anthropic 插件默认已捆绑并启用；当本地 ~/.claude/projects/ 目录存在时，原生 macOS 节点会公布只读的 Claude 会话命令。请在这些命令首次出现时批准节点配对升级。侧边栏按 Gateway 或配对节点主机对各行进行分组，并在每台计算机响应后立即显示该主机最新的受限页面。它会在主机连接状态发生变化时、页面重新获得焦点时，以及页面可见期间最多每 30 秒再次进行协调，因此在 OpenClaw 外部创建的 Claude 会话无需重新加载即可显示。目录发生变化时会更快地执行后续检查。使用目录分组下方的 加载更多会话，可为所有拥有更多历史记录的主机追加下一页；追加的行会继续显示，并在刷新时重新获取到相同的深度。目录客户端使用 sessions.catalog.list；打开某一行时使用 sessions.catalog.read。终端接管会先从所属主机用户的登录 shell PATH 中解析 claude，然后才使用服务／守护进程的 PATH。这样可以确保应用启动的会话与操作员在普通终端中使用的 Claude CLI 保持一致。选择某一行时会先读取最新的转录页面。加载更早的转录项 会遵循一个不透明的字节游标，并从 JSONL 文件中读取另一个受限区段，而不是加载全部历史。普通的用户、助手、推理、工具调用和工具结果内容都会被保留。单个条目如果大于节点／Gateway 的安全上限，会被清楚地标记为已截断。对于 Gateway 本地的 claude-cli 行，在普通撰写器中输入会调用 sessions.catalog.continue。OpenClaw 会重新解析本地目录记录，创建或复用一个模型锁定的原生会话，导入最多 200 个可见条目或 512 KiB，并为 Claude CLI 绑定播种。第一次回合会使用 --fork-session 继续；Claude 会为这个分叉分配一个新的会话 ID，因此后续回合会使用该分叉，而源会话保持不变。无头节点主机也可以通过启用下面的节点本地设置并重启节点主机，让其 Claude CLI 行具备继续功能：

{
  nodeHost: {
    agentRuns: {
      claude: { enabled: true },
    },
  },
}

只有在启用该设置且其本地 claude 可执行文件可解析时，节点才会公布 agent.cli.claude.run.v1。OpenClaw 会在该节点上重新解析目录记录，导入相同的受限历史，并将已接管的会话绑定到该节点以及目录报告的工作目录。每一轮都会使用该节点真实的 claude -p 进程运行，并使用该节点自己的 Claude 文件和登录状态。该节点的执行批准策略仍然适用；Gateway 不能强制进行该选择加入。节点继续功能 v1 仅限单次使用。它省略了 Gateway 回环 MCP 配置和 Gateway skills 插件参数，不会从 Gateway 转录中重新播种，并拒绝附件和图像。Claude Desktop 行仍然仅可查看。原生 macOS 应用节点在应用公布运行命令之前也仍然仅可查看。

配对节点上的 Claude 会话仍为只读，除非无头节点明确公布 agent.cli.claude.run.v1。OpenClaw 从不修改 Claude Desktop 元数据，也不会归档 Claude 会话。该页面需要具有写入范围的操作员连接，因为它使用经过身份验证的 node.invoke；即使在启用继续功能的节点上，list 和 read 仍然是只读的。

有关节点命令和安全边界，请参阅节点：Claude 会话和转录。

实时模型发现

配置 Anthropic API 密钥后，OpenClaw 会从 Anthropic 的模型端点刷新 Claude 模型目录，因此新发布的受支持模型系列快照无需等待 OpenClaw 发布新版本即可显示。已发布目录中已有描述的模型始终保留其已发布的元数据和定价。只有当 Anthropic 宣称的能力与 OpenClaw 将对该模型应用的请求构造方式相匹配时，新发现的模型才会提供使用。因此，全新一代模型会在 OpenClaw 为其添加支持之前保持隐藏，而不会出现在选择器中后导致每次请求都失败。发现功能仅提供参考：如果没有 API 密钥，或无法访问该端点，则使用已发布的目录，不作任何更改。

思考默认设置（Claude Opus 5、Sonnet 5、Mythos 5、Fable 5、4.8 和 4.6）

不带版本号的系列别名会滚动更新：opus 跟踪当前支持的 Claude Opus 版本，目前解析为 anthropic/claude-opus-5，sonnet 也以同样的方式跟踪当前 Sonnet 版本。因此，升级 OpenClaw 可能会将使用 opus 的配置迁移到更新的模型版本。固定版本即可选择退出——诸如 opus-4.8 这样的带版本别名会继续解析到其对应的模型，而已经明确指定 claude-opus-4-8 的配置则永远不会被重写。 anthropic/claude-opus-5 默认使用 high 努力级别的自适应思考。使用 /think off 可禁用思考，或使用 /think xhigh|max 启用模型更高的原生努力级别。由于 Anthropic 不支持该模型的这些请求功能，OpenClaw 会省略 Opus 5 的手动思考预算、自定义采样参数、助手预填充和 Priority Tier。该目录公布其 1,000,000-token 上下文窗口、128,000-token 输出上限、图像输入能力，以及 $5/$25 输入/输出定价。 anthropic/claude-sonnet-5 使用相同的自适应思考默认设置和请求限制。该目录采用 Anthropic 的入门 $2/$10 输入/输出定价，持续至 2026 年 8 月 31 日；标准的 $3/$15 定价将于 2026 年 9 月 1 日开始。 anthropic/claude-fable-5 始终使用自适应思考，并默认设为 high 努力级别。Anthropic 不允许为该模型禁用思考，因此 /think off 和 /think minimal 会映射为 low 努力级别。OpenClaw 也会省略 Fable 5 请求中的自定义温度值，因为 Anthropic 会拒绝对任何启用思考的请求进行温度覆盖。 anthropic/claude-mythos-5 是一个限量开放访问模型，采用相同的始终开启自适应思考协议。OpenClaw 默认设为 high，将 /think off 和 /think minimal 映射为 low，并省略调用方选择的采样参数。该目录公布其 1,000,000-token 上下文窗口、128,000-token 输出上限、图像输入能力，以及 $10/$50 输入/输出定价。 Claude Opus 4.8 在 OpenClaw 中默认关闭思考。当你通过 /think high|xhigh|max 显式启用自适应思考时，OpenClaw 会发送 Anthropic 的 Opus 4.8 努力级别值； Claude 4.6 模型（Opus 4.6 和 Sonnet 4.6）默认使用 adaptive。可通过 /think:<level> 按消息覆盖，或在模型参数中设置：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}

安全拒绝回退（Claude Opus 5 和 Fable 5）

Claude Opus 5 和 Fable 5 可以将安全分类器的拒绝路由到另一个 Claude 模型。对于直接 API 密钥请求，OpenClaw 采用 Anthropic 推荐的按类别路由方式。通过回退提供服务的轮次将按照实际响应模型的费率计费。如果您的策略要求每一轮都必须使用所请求的模型，请不要通过自动回退路径使用这些模型。

为什么需要此功能

Opus 5 和 Fable 5 分类器会在受限领域的请求上返回 stop_reason: "refusal"。如果没有回退，即使 Anthropic 针对该拒绝类别提供了推荐模型，该轮也会以错误结束。

工作原理

对于发送到 anthropic/claude-opus-5 或 anthropic/claude-fable-5 的每个直接 API 密钥请求，OpenClaw 都会发送 server-side-fallback-2026-07-01 beta 标头以及 fallbacks: "default"。Anthropic 会为报告的拒绝类别选择推荐模型。
只有安全分类器拒绝才会触发回退。速率限制、过载和服务器错误的行为与之前完全相同，并会通过 OpenClaw 的常规模型故障转移流程处理。
救援过程发生在同一次调用中。如果在产生任何输出之前发生拒绝，除了延迟增加之外不会有其他可见变化；整个答案都来自提供服务的模型。如果在流式传输中途发生拒绝，已生成的部分文本会作为前缀保留，由回退模型继续生成；根据 Anthropic 的重放规则，被拒绝模型的推理和工具调用都会被丢弃（不得将其回显或执行）。
如果推荐模型也拒绝，该轮会将拒绝作为错误返回。

回退发生在 Anthropic API 层，因此提供服务的模型无需位于您配置的 OpenClaw 回退链中。

可观测性与计费

通过回退提供服务的轮次会在 assistant 消息上记录一个 provider_fallback 诊断信息，其中包含 fromModel 和 toModel，而消息的 responseModel 会报告实际响应的模型。
Anthropic 会按照提供服务的模型费率为回退尝试计费。对于已知的 Opus 4.8 回退服务轮次，OpenClaw 按 Opus 4.8 的费率计价。
流式传输中途发生拒绝时，Anthropic 还会对已流式传输的主模型部分另行计费；该部分会在 API 的每次尝试用量中报告，但不会计入 OpenClaw 的每轮估算。

适用范围

适用于使用 API 密钥身份验证、针对 api.anthropic.com 的 anthropic/claude-opus-5 和 anthropic/claude-fable-5。OAuth（包括复用 Claude CLI 订阅）、代理基础 URL、Bedrock、Vertex 和 Foundry 请求均不受影响，在这些场景中拒绝仍会作为错误返回。请参阅 Anthropic 的拒绝与回退指南了解其底层行为。

提示词缓存

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

值	缓存时长	说明
`"short"`（默认）	5 分钟	针对 API key 认证自动应用
`"long"`	1 小时	扩展缓存
`"none"`	不缓存	禁用提示词缓存

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

每个代理的缓存覆盖

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

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

配置合并顺序：

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

这样一个代理可以保留长期缓存，而同一模型上的另一个代理可以为突发/低复用流量禁用缓存。

Bedrock Claude 说明

Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在配置后接受 cacheRetention 透传。
非 Anthropic 的 Bedrock 模型在运行时会被强制设为 cacheRetention: "none"。
当未设置显式值时，API key 智能默认值也会为 Claude-on-Bedrock 引用填入 cacheRetention: "short"。

高级配置

快速模式

对于 Claude Opus 5 和 Opus 4.8，OpenClaw 的共享 /fast 开关会对直接发送到 api.anthropic.com 的 API 密钥流量使用 Anthropic 的原生快速模式。

命令	映射为
`/fast on`	`speed: "fast"` 加上 `fast-mode-2026-02-01`
`/fast off`	标准速度；不包含 `speed` 字段

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

原生快速模式是 Claude Opus 5 和 Opus 4.8 的研究预览功能。它可将输出令牌吞吐量提高至最高 2.5 倍，计费标准为每百万输入/输出令牌 $10/$50。OpenClaw 会在成本估算中对缓存价格采用相同的 2 倍乘数。
原生快速模式仅适用于使用 API 密钥发送到 api.anthropic.com 的直接请求。OAuth/订阅令牌请求、Claude CLI、代理、Bedrock、Vertex 和 Foundry 均不会收到 beta 或 speed 字段。
账户需要具备快速模式访问权限以及非零的快速模式速率限制。当单独的快速模式配额耗尽或为零时，Anthropic 会返回专用的快速模式 429。
对于其他直接 Anthropic 模型，/fast 会保留现有的 Priority Tier 映射：开启时使用 service_tier: "auto"，关闭时使用 service_tier: "standard_only"。
同时设置时，显式的 serviceTier 或 service_tier 参数会覆盖 /fast。
Claude Sonnet 5 既不支持原生快速模式，也不支持 Priority Tier，因此 OpenClaw 会省略这两个字段。

媒体理解（图片和 PDF）

内置的 Anthropic 插件已注册图片和 PDF 理解能力。OpenClaw 会根据已配置的 Anthropic 认证自动解析媒体能力；无需额外配置。

属性	值
默认模型	`claude-opus-5`
支持的输入	图片、PDF 文档

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

1M 上下文窗口

Claude Opus 5、Sonnet 5、Mythos 5 和 Fable 5 具有精确的 1,000,000 令牌输入窗口，并支持最多 128,000 个输出令牌。 Anthropic 的 1M 上下文窗口现已在支持自适应思考的 Claude 4.x 模型上正式可用： Opus 4.8、 Opus 4.7、Opus 4.6 和 Sonnet 4.6。OpenClaw 会自动为这些模型设置大小，无需使用 params.context1m：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-5": {},
        "anthropic/claude-sonnet-5": {},
        "anthropic/claude-mythos-5": {},
        "anthropic/claude-opus-4-8": {},
      },
    },
  },
}

旧配置可以保留 params.context1m: true；对于这些模型来说这只是一个无害的空操作，而且 OpenClaw 现在无论如何都不会再发送已弃用的 context-1m-2025-08-07 beta 头。旧的 anthropicBeta 配置项中包含该值的条目会在请求头解析时被丢弃，不受支持的旧 Claude 模型仍会保持其正常的上下文窗口。对 Claude CLI 后端（claude-cli/*）来说，params.context1m: true 的行为也完全相同：符合条件且支持 GA 的 Opus 和 Sonnet 模型本就会自动获得 1M 窗口，因此这里该参数同样是可选的。

需要你的 Anthropic 凭证具备长上下文访问权限。OAuth/订阅令牌认证会保留其所需的 Anthropic beta 头，但如果旧配置中仍保留了已废弃的 1M beta 头，OpenClaw 会将其移除。

Claude Opus 5 1M 上下文

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

故障排除

401 错误／令牌突然失效

Anthropic token 认证会过期，也可能被撤销。对于新配置，建议改用 Anthropic API key。

未找到提供方 "anthropic" 的 API key

Anthropic 认证是按代理生效的；新代理不会继承主代理的密钥。请为该代理重新运行初始化（或在网关主机上配置 API key），然后使用 openclaw models status 进行验证。

未找到配置文件 "anthropic:default" 的凭证

运行 openclaw models status 查看当前激活的是哪个认证配置文件。重新运行初始化，或为该配置文件路径配置 API key。

没有可用的认证配置文件（全部处于冷却中）

检查 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 的速率限制冷却可能是按模型范围生效的，因此同组中的另一个 Anthropic 模型也许仍可使用。添加另一个 Anthropic 配置文件，或等待冷却结束。

更多帮助：故障排除和 FAQ。

模型选择

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

CLI 后端

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

提示词缓存

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

OAuth 和认证

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

概览

概念与配置

提供商

使用与成本跟踪

开始使用

配置示例

获取设置令牌

配置示例

计费与 `claude -p`

不同电脑上的 Claude 会话

实时模型发现

思考默认设置（Claude Opus 5、Sonnet 5、Mythos 5、Fable 5、4.8 和 4.6）

安全拒绝回退（Claude Opus 5 和 Fable 5）

为什么需要此功能

工作原理

可观测性与计费

适用范围

提示词缓存

高级配置

故障排除

相关内容

模型选择

CLI 后端

提示词缓存

OAuth 和认证

​使用与成本跟踪

​开始使用

​配置示例

​获取设置令牌

​配置示例

​计费与 claude -p

​不同电脑上的 Claude 会话

​实时模型发现

​思考默认设置（Claude Opus 5、Sonnet 5、Mythos 5、Fable 5、4.8 和 4.6）

​安全拒绝回退（Claude Opus 5 和 Fable 5）

​为什么需要此功能

​工作原理

​可观测性与计费

​适用范围

​提示词缓存

​高级配置

​故障排除

​相关内容

模型选择

CLI 后端

提示词缓存

OAuth 和认证

使用与成本跟踪

开始使用

配置示例

获取设置令牌

配置示例

计费与 `claude -p`

不同电脑上的 Claude 会话

实时模型发现

思考默认设置（Claude Opus 5、Sonnet 5、Mythos 5、Fable 5、4.8 和 4.6）

安全拒绝回退（Claude Opus 5 和 Fable 5）

为什么需要此功能

工作原理

可观测性与计费

适用范围

提示词缓存

高级配置

故障排除

相关内容