Anthropic

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

​

用量和成本跟踪

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

​

入门指南

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 会话

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

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

​

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

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

​

安全拒绝回退（Claude Fable 5）

​

此机制为何存在

​

工作原理

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 也拒绝，该轮次会将拒绝作为 错误返回，与此功能推出前完全相同。

​

可观测性和计费

• 由回退模型处理的轮次会在助手消息中记录 provider_fallback 诊断信息， 其中会注明 fromModel 和 toModel，且该消息的 responseModel 会报告 claude-opus-4-8。
• Anthropic 按尝试计费：在输出前拒绝不收费，补救请求 按 Claude Opus 4.8 费率计费（目前是 Fable 5 费率的一半）。OpenClaw 会按 Opus 费率估算由回退模型处理的轮次费用，以保持一致。
• 如果在流式传输过程中拒绝，Anthropic 还会对已流式输出的 Fable 部分 计费；该部分会在 API 的各次尝试用量中报告， 但不会计入 OpenClaw 的单轮费用估算。

​

适用范围

​

提示词缓存

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

​

故障排查

​

相关内容