OpenClaw Anthropic 接入教程，API Key 配置和提示缓存指南

根据官方 Anthropic 文档，OpenClaw 支持两条认证路径：

• Anthropic API Key
• Claude setup-token

方式 A：Anthropic API Key#

这是更推荐的大多数用户起点，适合：

• 标准 API 访问
• 按量计费
• 更直接、可控的模型接入

CLI 设置

官方给出的命令是：

openclaw onboard
# 选择：Anthropic API key

非交互方式：

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

配置示例

官方配置片段是：

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

方式 B：Claude setup-token#

这条路更适合已经处在 Anthropic 订阅或 setup-token 场景中的用户。相比直接 API Key，普通用户通常不需要优先走这条路。

提示缓存是 Anthropic 这条线的一个重点#

官方文档特别提到 Anthropic API 支持提示缓存。

在模型参数中可以设置：

• none
• short
• long

其中：

• short 是 API Key 路线下的默认值
• long 用于更长缓存，但会涉及额外要求

官方示例：

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

什么时候最适合先用 Anthropic#

如果你更关注：

• 稳定主模型
• 清晰 API 路径
• 更成熟的长对话体验

Anthropic 往往是很适合的起点之一。

配完后如何验证#

建议至少执行：

openclaw status --deep
openclaw models status

先确认认证和默认模型是正确的，再去调优提示缓存或切换模型。