跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Anthropic 构建 Claude 模型系列。OpenClaw 支持两种认证路径：
  • API 密钥 — 使用基于用量计费的 Anthropic API 直接访问（anthropic/* 模型）
  • Claude CLI — 在同一主机上复用已有的 Claude CLI 登录
Anthropic 员工告诉我们，OpenClaw 风格的 Claude CLI 用法已重新被允许，因此 OpenClaw 将 Claude CLI 复用和 claude -p 用法视为已获准，除非 Anthropic 发布新的政策。对于长期运行的 Gateway 网关主机，Anthropic API 密钥仍然是最清晰且 最可预测的生产路径。Anthropic 当前的公开文档：

​
入门指南

最适合： 标准 API 访问和基于用量的计费。
1

获取你的 API 密钥

在 Anthropic Console 中创建 API 密钥。
2

运行新手引导

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

验证模型可用

openclaw models list --provider anthropic

​
配置示例

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​
思考默认值（Claude 4.6）

当未设置显式思考级别时，Claude 4.6 模型在 OpenClaw 中默认使用 adaptive 思考。 可用 /think:<level> 按消息覆盖，或在模型参数中覆盖： 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
相关 Anthropic 文档：

​
提示词缓存

OpenClaw 对 API 密钥认证支持 Anthropic 的提示词缓存功能。
值缓存时长描述
"short"（默认）5 分钟对 API 密钥认证自动应用
"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 密钥智能默认值也会为 Claude-on-Bedrock 引用填入 cacheRetention: "short"。

​
高级配置

OpenClaw 的共享 /fast 开关支持 Anthropic 直连流量（API 密钥和 OAuth 到 api.anthropic.com）。
命令映射到
/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 认证自动解析媒体能力，无需 额外配置。
属性值
默认模型claude-opus-4-7
支持的输入图像、PDF 文档
当图像或 PDF 附加到对话时，OpenClaw 会自动 通过 Anthropic 媒体理解提供商进行路由。
Anthropic 的 1M 上下文窗口受 beta 门控。按模型启用：
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}
OpenClaw 会在请求上将其映射为 anthropic-beta: context-1m-2025-08-07。params.context1m: true 也适用于符合条件的 Opus 和 Sonnet 模型的 Claude CLI 后端 （claude-cli/*），将这些 CLI 会话的运行时 上下文窗口扩展到与直连 API 行为一致。
需要你的 Anthropic 凭证具备长上下文访问权限。旧版令牌认证（sk-ant-oat-*）会被 1M 上下文请求拒绝，OpenClaw 会记录警告并回退到标准上下文窗口。
anthropic/claude-opus-4.7 及其 claude-cli 变体默认具有 1M 上下文 窗口，无需 params.context1m: true。

​
故障排除

Anthropic 令牌认证会过期，也可能被撤销。对于新设置，请改用 Anthropic API 密钥。
Anthropic 认证是按智能体配置的，新智能体不会继承主智能体的密钥。为该智能体重新运行新手引导（或在 Gateway 网关主机上配置 API 密钥），然后用 openclaw models status 验证。
运行 openclaw models status 查看当前活动的认证配置文件。重新运行新手引导，或为该配置文件路径配置 API 密钥。
检查 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 速率限制冷却可能按模型限定，因此同级 Anthropic 模型可能仍可使用。添加另一个 Anthropic 配置文件，或等待冷却结束。
更多帮助：故障排除 和 常见问题。

​
相关内容

模型选择

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

CLI 后端

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

提示词缓存

提示词缓存在不同提供商之间的工作方式。

OAuth 和认证

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