必须将Anthropic API Key注入OpenClaw配置体系,否则因认证失败导致401错误、模型列表为空或请求被拒;需确保版本≥1.8.0,执行openclaw init生成唯一有效配置文件,并通过~/.openclaw/.env安全写入密钥。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在OpenClaw中稳定调用Claude模型,必须将第三方API Key正确注入配置体系,否则网关启动后会报401错误、模型列表为空或请求直接被拒绝——这不是网络问题,而是凭证未加载导致的身份认证失败。
确认OpenClaw版本与初始化
打开终端,执行openclaw --version,确保输出≥1.8.0;若低于该版本,运行brew upgrade openclaw(macOS)或对应包管理命令升级。
执行openclaw init,该命令会生成~/.openclaw/openclaw.json(Linux/macOS)或C:Users\.openclawopenclaw.json(Windows),【这是唯一有效的配置入口,其他路径修改无效】。
安全写入Anthropic API Key
推荐使用.env文件方式持久化密钥,避免硬编码泄露风险。
在终端中执行:
cat >> ~/.openclaw/.env ANTHROPIC_API_KEY=sk-ant-v0-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
EOF
⚠️ 注意:请将sk-ant-v0-...替换为你从Anthropic控制台获取的真实Key,复制时务必剔除前后空格和换行符;【一旦粘贴错误,后续所有请求均返回401且无明确提示】。
执行chmod 600 ~/.openclaw/.env,防止其他用户读取密钥文件。
统一安全套件,为代理工作区提供一键安装、配置和编排全部11个OpenClaw安全工具——完整性、密钥、权限、网络、审计跟踪、签名、供应链、凭证、注入防护、合规与事件响应。
修改openclaw.json启用Claude Provider
第一步:用编辑器打开~/.openclaw/openclaw.json(Windows用户可用记事本,macOS/Linux建议用VS Code或vim)。
第二步:定位到"providers"数组,在其末尾插入以下完整对象(注意逗号分隔):
{
"name": "anthropic",
"type": "anthropic",
"base_url": "https://api.anthropic.com/v1",
"models": [
"claude-3-5-sonnet-20241022",
"claude-3-haiku-20240307"
]
}
第三步:找到"default_provider"字段,将其值改为"anthropic";若不存在该字段,则在根对象第一层添加"default_provider": "anthropic"。
第四步:保存文件。不要用“另存为”,确保覆盖原文件;【文件编码必须为UTF-8无BOM,否则OpenClaw解析失败且不报错】。
重启网关并验证模型挂载
执行openclaw gateway restart,等待输出Gateway restarted successfully。
立即运行openclaw models status,观察输出中是否包含anthropic/claude-3-5-sonnet-20241022且状态为active。
若显示unavailable或报错Failed to list models: unauthorized,说明.env未被读取或Key格式错误,请检查~/.openclaw/.env文件权限及内容。

















