在OpenClaw部署或使用过程中,即使没有使用Anthropic模型,系统仍然提示 Missing API Key / No API Key Found / Anthropic API Key Required 是非常常见的问题。该错误通常不是因为真的在使用Anthropic,而是由于模型Provider配置错误、默认模型指向Claude、Alias映射错误、环境变量残留、Workflow绑定错误、默认Provider未修改、数据库缓存未刷新、Docker环境变量未清理等原因导致。要彻底解决该问题,需要从模型配置、Provider绑定、默认模型、API Key列表、环境变量、配置文件、数据库缓存等多个层面排查。
一、确认当前默认模型是否仍指向Anthropic
OpenClaw在未指定模型时,会调用默认模型。如果默认模型是Claude,则系统会强制检查Anthropic Key。
进入:
检查是否为:
- claude
- claude-3
- anthropic
- sonnet
如果是,需要改为:
- gpt-4o
- gpt-4o-mini
- local
- deepseek
示例:
default_model = gpt-4o-mini
二、检查模型Provider是否仍然是anthropic
即使模型名称不是Claude,只要Provider是anthropic,也会要求Key。
进入:
检查:
provider: anthropic
需要改为:
provider: openai
或:
provider: ollama
或:
provider: custom
三、检查Alias映射是否指向Claude
Alias错误是最常见原因。
示例错误:
fast -> claude-3-sonnet
调用:
model = fast
系统会查找Anthropic Key。
解决:
fast -> gpt-4o-mini
四、检查Workflow是否绑定Anthropic模型
Workflow保存旧模型时,也会触发Key检查。
进入:
检查:
model = claude
改为:
model = gpt4
五、检查Agent配置
Agent可能绑定Claude。
进入:
检查:
model = claude
改为:
model = fast
六、检查.env是否存在Anthropic Key变量
如果存在但为空,会报错。
检查:
cat .env
如果有:
ANTHROPIC_API_KEY=
需要删除或填写:
# 删除
ANTHROPIC_API_KEY
七、检查docker-compose环境变量
Docker环境中如果声明了Anthropic变量但为空,会报错。
错误:
ANTHROPIC_API_KEY=
正确:
# 删除
或:
ANTHROPIC_API_KEY=xxx
修改后:
docker compose down
docker compose up -d
八、检查Provider列表
OpenClaw有时默认启用Anthropic Provider。
进入:
关闭:
或删除Key配置。
九、检查Token URL是否绑定Anthropic
如果Token URL指向Anthropic接口,也会报错。
错误:
https://api.anthropic.com
正确:
https://api.openai.com/v1
或:
http://127.0.0.1:11434/v1
十、检查数据库缓存
旧配置可能仍在数据库中。
进入:
sqlite3 data.db
查看模型:
select * from models;
查看key:
select * from api_keys;
删除anthropic记录。
十一、清理缓存后重启
docker stop openclaw
docker rm openclaw
docker compose up -d
或:
rm -rf cache
rm -rf tmp
十二、检查本地模型Provider
本地模型不能写anthropic。
错误:
provider: anthropic
正确:
provider: ollama
或:
provider: openai-compatible
十三、检查多模型自动回退
OpenClaw支持Fallback模型。
如果fallback是Claude,会要求Key。
示例:
fallback = claude
改为:
fallback = gpt4
十四、检查版本兼容
旧版本会默认加载Anthropic。
升级:
docker pull openclaw/openclaw:latest
重启:
docker compose up -d
十五、推荐安全配置
OPENAI_API_KEY=sk-xxx
GEMINI_API_KEY=xxx
# 不写Anthropic
模型:
fast = gpt-4o-mini
smart = gpt-4.1
local = llama3
默认:
default_model = fast
使用该配置可以避免OpenClaw不用Anthropic却提示缺少API Key的问题。 |