OpenClaw 对 Anthropic 的原生支持,提供两种认证方式,并内置提示缓存、思考模式、媒体理解等高级功能。
认证方式
API Key 认证(直接调用 Anthropic API):
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: {
defaults: { model: { primary: "anthropic/claude-opus-4-6" } }
}
}Claude CLI 认证(复用已有 Claude Code 登录,无需额外 API key):
{
agents: {
defaults: { model: { primary: "anthropic/claude-opus-4-6" } }
}
}核心功能
思考模式
Claude 4.6 默认启用 adaptive thinking(自适应思考),根据任务复杂度动态决定是否推理。无需手动配置。
提示缓存
控制 prompt cache 策略,降低重复请求成本:
| 值 | 缓存时长 | 说明 |
|---|---|---|
short | 5 分钟 | API key 认证默认值 |
long | 1 小时 | 适合长会话 |
none | 不缓存 | 关闭缓存 |
{
providers: {
anthropic: { promptCache: "long" }
}
}快速模式
/fast on 命令启用快速模式,底层设置 service_tier: "auto",优先使用低延迟路由。
媒体理解
支持图像和 PDF 输入,OpenClaw 自动路由到支持多模态的模型端点,无需额外配置。
1M 上下文窗口(Beta)
启用超长上下文支持:
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-6" },
params: { context1m: true }
}
}
}故障排除
| 错误 | 原因 | 解决方案 |
|---|---|---|
401 Unauthorized | API key 无效或过期 | 检查 ANTHROPIC_API_KEY 值 |
No API key found | 未设置环境变量 | 配置 env.ANTHROPIC_API_KEY |
No credentials found | CLI 未登录 | 运行 claude login |
cooldown | 请求频率超限 | 等待冷却或切换到 API key 认证 |
相关
- providers — 所有提供商概览与对比
- model-providers — 模型选择与故障转移机制
- gateway-auth — 认证配置详解