提供商
Anthropic
Anthropic 构建 Claude 模型家族。OpenClaw 支持两种凭证方式：
- API key — 使用基于用量计费的 Anthropic API 直接访问（
anthropic/*模型） - Claude CLI — 复用同一主机上已有的 Claude CLI 登录
入门指南
API key
最适合： 标准 API 访问和基于用量计费。
获取你的 API key
在 Anthropic Console 中创建 API key。
运行新手引导
openclaw onboard
# choose: Anthropic API key
或直接传入密钥：
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
验证模型是否可用
openclaw models list --provider anthropic
配置示例
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Claude CLI
最适合： 在不使用单独 API key 的情况下复用已有 Claude CLI 登录。
确保已安装 Claude CLI 并已登录
使用以下命令验证：
claude --version
运行新手引导
openclaw onboard
# choose: Claude CLI
OpenClaw 会检测并复用已有的 Claude CLI 凭证。
验证模型是否可用
openclaw models list --provider anthropic
配置示例
优先使用规范的 Anthropic 模型引用，并添加 CLI 运行时覆盖：
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
旧版 claude-cli/claude-opus-4-7 模型引用仍可用于
兼容性，但新的配置应将提供商/模型选择保持为
anthropic/*，并将执行后端放在 agentRuntime.id 中。
思考默认值（Claude 4.6）
在 OpenClaw 中，如果没有显式设置思考级别，Claude 4.6 模型默认使用 adaptive 思考。
可通过 /think:<level> 按消息覆盖，或在模型参数中覆盖：
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
提示缓存
OpenClaw 支持用于 API key 凭证的 Anthropic 提示缓存功能。
| 值 | 缓存时长 | 说明 |
|---|---|---|
"short"（默认） |
5 分钟 | 对 API key 凭证自动应用 |
"long" |
1 小时 | 扩展缓存 |
"none" |
不缓存 | 禁用提示缓存 |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
按 agent 覆盖缓存
使用模型级参数作为基线，然后通过 agents.list[].params 覆盖特定 agent：
{
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["provider/model"].paramsagents.list[].params（匹配id，按键覆盖）
这样可以让一个 agent 保持长生命周期缓存，同时让同一模型上的另一个 agent 针对突发/低复用流量禁用缓存。
Bedrock Claude 注意事项
- Bedrock 上的 Anthropic Claude 模型（
amazon-bedrock/*anthropic.claude*）在配置后接受cacheRetention透传。 - 非 Anthropic Bedrock 模型在运行时会被强制设为
cacheRetention: "none"。 - 当未设置显式值时，API key 智能默认值也会为 Claude-on-Bedrock 引用填充
cacheRetention: "short"。
高级配置
快速模式
OpenClaw 的共享 /fast 开关支持直连 Anthropic 流量（API key 和到 api.anthropic.com 的 OAuth）。
| 命令 | 映射到 |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
params: { fastMode: true },
},
},
},
},
}
媒体理解（图像和 PDF）
内置 Anthropic 插件会注册图像和 PDF 理解。OpenClaw 会从已配置的 Anthropic 凭证中自动解析媒体能力，无需 额外配置。
| 属性 | 值 |
|---|---|
| 默认模型 | claude-opus-4-7 |
| 支持的输入 | 图像、PDF 文档 |
当图像或 PDF 附加到对话时，OpenClaw 会自动 通过 Anthropic 媒体理解提供商路由它。
1M 上下文窗口（beta）
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 会话的运行时
上下文窗口，使其与 direct-API 行为一致。
Claude Opus 4.7 1M 上下文
anthropic/claude-opus-4.7 及其 claude-cli 变体默认拥有 1M 上下文
窗口，无需 params.context1m: true。
故障排除
401 错误 / token 突然失效
Anthropic token 凭证会过期，也可能被撤销。对于新设置，请改用 Anthropic API key。
未找到 provider "anthropic" 的 API key
Anthropic 凭证是按 agent配置的，新 agent 不会继承主 agent 的密钥。为该 agent 重新运行新手引导（或在 Gateway 网关主机上配置 API key），然后使用 openclaw models status 验证。
未找到 profile "anthropic:default" 的凭证
运行 openclaw models status 查看当前处于活动状态的凭证配置档案。重新运行新手引导，或为该配置档案路径配置 API key。
没有可用的凭证配置档案（全部处于冷却中）
查看 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 速率限制冷却可能限定到模型范围，因此同级 Anthropic 模型可能仍然可用。添加另一个 Anthropic 配置档案，或等待冷却结束。