Anthropic

Anthropic 构建 Claude 模型系列。OpenClaw 支持两种身份验证方式：

• API key - 使用按量计费的方式直接访问 Anthropic API（anthropic/* 模型）
• Claude CLI - 复用同一主机上现有的 Claude Code 登录

用量和费用跟踪

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

• Claude 订阅/设置凭据会显示配额周期和可选的额外用量预算。
• ANTHROPIC_ADMIN_KEY 或 ANTHROPIC_ADMIN_API_KEY 会在 Control UI 的 用量 中显示提供商报告的 30 天组织费用和 Messages API 用量，包括每日支出、令牌/缓存总量、热门模型和费用类别。
• Anthropic 提供商配置文件中存储的 sk-ant-admin... 凭据会被自动识别为 Admin API key。

Admin API 费用历史记录来自 Anthropic 的 Usage and Cost API。这是提供商的实际账单，与 OpenClaw 根据会话得出的估算费用相互独立。

入门指南

openclaw onboard# 选择：Anthropic API key

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

openclaw models list --provider anthropic

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

claude --version

openclaw onboard# 选择：Claude CLI

openclaw models list --provider anthropic

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

跨计算机的 Claude 会话

内置的 Anthropic 插件会在常规会话侧边栏中添加一个 Claude Code 分组。各行会在常规聊天窗格中打开。它会发现 Gateway 网关和已连接节点主机上未归档的 Claude Code 会话：

• Claude CLI 会话来自有效的项目索引记录和当前 JSONL 文件，这些文件受限长度的元数据前缀会标识 ~/.claude/projects/ 下的非侧链 sdk-cli 会话。
• 当 Claude Desktop 的元数据指向同一 Claude Code 会话 ID 时，其会话会使用 Desktop 标题、活动时间和归档状态。
• 仅 CLI 会话没有归档标志，因此只要其对话记录仍然存在，该会话便会保持可见。

无需额外的 OpenClaw 配置。Anthropic 插件已内置且默认启用；当本地 ~/.claude/projects/ 目录存在时，原生 macOS 节点会公布只读 Claude 会话命令。这些命令首次出现时，请批准节点配对升级。

侧边栏会从每台主机最新的受限页面开始，并按常规的 30 秒周期刷新。使用目录分组下方的 加载更多会话，可为每台仍有更多历史记录的主机追加下一页；追加的行会保持可见，并在刷新时以相同深度重新获取。目录客户端使用 sessions.catalog.list；打开一行时使用 sessions.catalog.read。

选择一行时，会先读取最新的对话记录页面。加载更早的对话记录项目 会沿用不透明的字节游标，从 JSONL 文件读取另一个受限区段，而不是加载完整历史记录。常规用户、助手、推理、工具调用和工具结果内容均会保留。超过节点/Gateway 网关安全上限的单个项目会明确标记为已截断。

对于 Gateway 网关本地的 claude-cli 行，在常规编辑器中输入内容会调用 sessions.catalog.continue。OpenClaw 会重新解析本地目录记录，创建或复用模型锁定的原生会话，导入最多 200 个可见项目或 512 KiB，并初始化 Claude CLI 绑定。第一轮使用 --fork-session 恢复；Claude 会为分叉分配新的会话 ID，因此后续轮次使用该分叉，而源会话保持不变。Claude Desktop 和配对节点中的行仅可查看。

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

思考默认值（Claude Sonnet 5、Mythos 5、Fable 5、4.8 和 4.6）

anthropic/claude-sonnet-5 默认使用 high 强度的自适应思考。使用 /think off 可禁用思考，使用 /think xhigh|max 可启用模型更高的原生强度级别。对于 Sonnet 5，OpenClaw 会省略手动思考预算、自定义采样参数、助手预填充和 Priority Tier，因为 Anthropic 不支持在此模型的请求中使用这些功能。 目录采用 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 令牌上下文窗口、128,000 令牌输出限制、图像输入功能以及 $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-4-8": {          params: { thinking: "high" },        },      },    },  },}

安全拒绝回退（Claude Fable 5）

此机制存在的原因

对于受限领域中的请求，Fable 5 分类器会返回 stop_reason: "refusal"，同时也会对接近敏感领域的正常工作产生误报（安全工具、生命科学，甚至只是要求模型复现其原始推理过程）。如果没有回退机制，即使其他 Claude 模型能够正常处理，该轮次仍会因错误而终止——Anthropic 自己的拒绝消息也会提示 API 集成方配置回退模型。

工作原理

1. 对于每个直接使用 API key 向 anthropic/claude-fable-5 发出的请求，OpenClaw 都会发送 Anthropic 的服务端回退加入配置：server-side-fallback-2026-06-01 beta 标头以及 fallbacks: [{"model": "claude-opus-4-8"}]。Claude Opus 4.8 是 Anthropic 唯一允许用于 Fable 5 的回退目标。
2. 只有安全分类器的拒绝才会触发回退。速率限制、过载和服务器错误的行为与之前完全相同，并会通过 OpenClaw 的常规模型故障转移机制处理。
3. 补救会在同一次调用中发生。如果在产生任何输出前被拒绝，除了延迟外不会留下可见痕迹；整个回答均来自 Opus 4.8。如果在流式传输中途被拒绝，已生成的部分文本会保留为回退模型继续生成时的前缀，而被拒绝模型的推理和工具调用会按照 Anthropic 的重放规则丢弃（不得将其回传或执行）。
4. 如果 Claude Opus 4.8 也拒绝请求，该轮次会像此功能推出之前一样，将拒绝呈现为错误。

回退发生在 Anthropic API 层，因此无需将 claude-opus-4-8 加入你配置的模型列表或回退链——能够使用 Fable 的 API key 始终可以调用 Opus。

可观测性和计费

• 由回退模型处理的轮次会在助手消息中记录一条 provider_fallback 诊断信息，其中包含 fromModel 和 toModel，并且消息的 responseModel 会报告 claude-opus-4-8。
• Anthropic 按每次尝试计费：产生输出前的拒绝免费，补救请求按 Claude Opus 4.8 费率计费（目前为 Fable 5 费率的一半）。为了保持一致，OpenClaw 会按 Opus 费率估算由回退模型处理的轮次成本。
• 如果在流式传输中途被拒绝，Anthropic 还会对 Fable 已流式传输的部分额外计费；该部分会在 API 的每次尝试用量中报告，但不会计入 OpenClaw 的单轮次估算。

适用范围

适用于通过 API key 身份验证向 api.anthropic.com 请求 anthropic/claude-fable-5 的情况。OAuth（复用 Claude CLI 订阅）、代理基础 URL、Bedrock、Vertex 和 Foundry 请求均不受影响，发生拒绝时仍会呈现为错误。

已通过实时验证：如果未配置回退，要求 Fable 5 复现其原始思维链的无害提示词会被拒绝，并返回 category: "reasoning_extraction"；通过 OpenClaw 发送同一提示词则会返回由 Opus 正常处理的回答，并附带 provider_fallback 诊断信息。

有关底层行为，请参阅 Anthropic 的拒绝和回退指南。

提示词缓存

OpenClaw 支持 Anthropic 面向 API key 身份验证的提示词缓存功能。

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

{  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" } },    ],  },}

高级配置

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

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

故障排查

相关内容