Anthropic

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

• API 密钥 - 通过按用量计费直接访问 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 密钥。

Admin API 成本历史记录来自 Anthropic 的用量和成本 API。这是提供商的实际账单，与 OpenClaw 根据会话估算的成本相互独立。

入门指南

openclaw onboard# 选择：Anthropic API 密钥

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-5" } } },}

claude --version

openclaw onboard# 选择：Claude CLI

openclaw models list --provider anthropic

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

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

跨计算机的 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 文件和登录信息，运行该节点真实的 claude -p 进程。节点的 Exec 审批策略仍然适用；Gateway 网关无法强制启用该选项。

节点续接 v1 仅支持单次运行。它不包含 Gateway 网关 local loopback MCP 配置和 Gateway 网关 Skills 插件参数，不会从 Gateway 网关对话记录重新初始化，并且会拒绝附件和图像。 Claude Desktop 行仍然只能查看。原生 macOS 应用节点也会保持只能查看，直到应用公布运行命令。

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

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

anthropic/claude-opus-5 默认使用 high 强度的自适应思考。 使用 /think off 可禁用思考，使用 /think xhigh|max 可启用模型原生的 更高强度级别。对于 Opus 5，OpenClaw 不会设置手动思考预算、自定义 采样参数、助手预填充和 Priority Tier，因为 Anthropic 不支持此模型使用 这些请求功能。目录中公布了其 1,000,000 token 上下文窗口、128,000 token 输出限制、图像输入以及 $5/$25 输入/输出定价。

anthropic/claude-sonnet-5 使用相同的自适应思考默认设置和请求 限制。目录在 2026 年 8 月 31 日之前采用 Anthropic 的入门 $2/$10 输入/输出 定价；标准 $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 输入/输出定价。

在 OpenClaw 中，Claude Opus 4.8 默认关闭思考。当你使用 /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 Fable 5）

此机制为何存在

Fable 5 分类器会对受限领域的请求返回 stop_reason: "refusal"， 也会对与这些领域相邻的无害工作产生误报（安全 工具、生命科学，甚至要求模型复现其原始 推理）。如果没有回退，即使另一个 Claude 模型愿意处理请求， 该轮次仍会以错误结束——Anthropic 自己的拒绝消息会要求 API 集成方配置回退模型。

工作原理

1. 对于向 anthropic/claude-fable-5 发出的每个直接 API key 请求，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-opus-5": {},        "anthropic/claude-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

故障排查

相关内容