Anthropic (Claude)
Anthropic 构建了 Claude 模型家族，提供业界领先的 AI 能力。在 OpenClaw 中，您可以通过 API 密钥或 setup-token 两种方式进行身份验证。
认证方式
OpenClaw 支持两种 Anthropic 认证方式：
API 密钥认证
适用于标准 API 访问和基于使用量的计费。这是最稳定、推荐的认证方式。获取 API 密钥
前往 Anthropic Console 创建您的 API 密钥。配置步骤
运行引导配置
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-6"
}
}
}
}
Setup Token 认证
适用于使用 Claude 订阅账户。Setup-token 由 Claude Code CLI 生成。策略说明： Setup-token 支持是为了技术兼容性。Anthropic 曾阻止部分订阅在 Claude Code 以外的工具中使用。请核查当前 Anthropic 服务条款，并根据您的风险承受能力决策。API 密钥认证是更安全、推荐的方式。
生成 Setup Token
在任意机器上运行：配置步骤
生成 token
在您的开发机器上运行 claude setup-token，复制生成的 token。
粘贴到网关主机
# 方式 1：通过引导配置
openclaw onboard --auth-choice setup-token
# 方式 2：直接粘贴
openclaw models auth paste-token --provider anthropic
设置默认模型
{
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-opus-4-6"
}
}
}
}
可用模型
Claude 4.6 系列
当前最新的 Claude 模型：
anthropic/claude-opus-4-6 - 最强大的模型，适用于最复杂的任务anthropic/claude-sonnet-4-6 - 平衡性能和成本
{
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-opus-4-6"
}
}
}
}
高级功能
自适应思考（Claude 4.6）
Claude 4.6 模型支持自适应思考功能，在 OpenClaw 中默认启用。
当未显式设置思考等级时，Anthropic Claude 4.6 模型在 OpenClaw 中默认采用 adaptive（自适应）思考。
配置思考等级
{
"agents": {
"defaults": {
"models": {
"anthropic/claude-opus-4-6": {
"params": {
"thinking": "adaptive"
}
}
}
}
}
}
adaptive - 自适应（默认）high - 深度思考low - 快速响应
相关文档：
提示缓存
OpenClaw 支持 Anthropic 的提示缓存功能，可显著降低成本并提高响应速度。
提示缓存功能仅限 API 密钥认证，订阅 setup-token 不支持缓存设置。
缓存配置选项
| 值 | 缓存时长 | 说明 |
|---|
none | 不缓存 | 禁用提示缓存 |
short | 5 分钟 | API 密钥认证默认值 |
long | 1 小时 | 延长缓存（需要 beta 标志） |
{
"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"
}
}
]
}
}
research agent 使用 long 缓存，而 alerts agent 禁用缓存。{
"agents": {
"defaults": {
"models": {
"anthropic/claude-opus-4-6": {
"params": {
"cacheRetention": "none"
}
}
}
}
}
}
默认行为
使用 Anthropic API 密钥认证时，OpenClaw 自动为所有 Anthropic 模型应用 cacheRetention: "short"（5 分钟缓存）。您可以在配置中显式设置来覆盖。
Bedrock Claude 说明
- Bedrock 上的 Anthropic Claude 模型（如
amazon-bedrock/*anthropic.claude*）支持 cacheRetention 配置
- 非 Anthropic 的 Bedrock 模型在运行时强制设置为
cacheRetention: "none"
- Anthropic API 密钥的智能默认也会为 Bedrock 上的 Claude 模型设置
cacheRetention: "short"
1M 上下文窗口（测试版）
Anthropic 的 1M 上下文窗口功能处于测试版阶段，针对支持的 Opus/Sonnet 模型可通过配置启用。
{
"agents": {
"defaults": {
"models": {
"anthropic/claude-opus-4-6": {
"params": {
"context1m": true
}
}
}
}
}
}
要求：
- Anthropic 必须允许该凭证使用长上下文
- 通常需要 API 密钥计费，或开启额外使用的订阅账户
- OAuth/订阅令牌当前不支持 1M 上下文
HTTP 429: rate_limit_error: Extra usage is required for long context requests
API 密钥轮换
OpenClaw 支持配置多个 Anthropic API 密钥，在遇到速率限制时自动轮换：
export ANTHROPIC_API_KEYS="sk-ant-key1,sk-ant-key2,sk-ant-key3"
故障排除
401 错误 / 令牌突然无效
问题： 认证突然失败，返回 401 错误。
解决方案：
- 如果使用 setup-token，重新运行
claude setup-token 生成新 token
- 在网关主机粘贴新 token：
openclaw models auth paste-token --provider anthropic
找不到提供商 “anthropic” 的 API 密钥
问题： 新建的 agent 无法访问 Anthropic。
原因： 认证是按 agent 分配的，新建 agent 不会自动继承主 agent 的密钥。
解决方案：
- 为该 agent 重新执行引导配置：
- 或在网关主机粘贴 token/API 密钥
- 验证：
找不到配置文件 anthropic:default 的凭证
问题： 配置文件缺失或未正确设置。
解决方案：
- 查看当前认证状态：
- 重新引导配置或粘贴 token/API 密钥
无可用认证配置文件（均处于冷却/不可用状态）
问题： 所有 API 密钥都达到速率限制。
解决方案：
- 查看详细状态：
openclaw models status --json
- 添加更多 API 密钥或等待冷却时间结束
OAuth token refresh failed
问题： 订阅令牌刷新失败。
解决方案：
- 重新生成 setup-token：
- 粘贴新 token 到网关主机
详细故障排除指南请参考：
完整配置示例
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-..."
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-opus-4-6"
},
"models": {
"anthropic/claude-opus-4-6": {
"params": {
"cacheRetention": "long",
"thinking": "adaptive"
}
}
}
}
}
}
相关资源
