OpenClaw怎么配置API_Key才不会出错？

OpenClaw 配置 API Key 出错，这事儿其实挺常见的，翻来覆去就那么几个原因：密钥硬编码在 JSON 配置文件里、不小心提交到 Git 仓库、环境变量没注入 systemd 进程，或者多个配置文件冲突导致网关读到了过期密钥。结果就是 401 认证失败、额度被扣光却毫无提示，甚至服务启动时直接静默崩溃——连个报错都看不到。

别看问题五花八门，只要抓住核心逻辑，解决起来并不复杂。下面从路径优先级、密钥替换、环境注入到最终验证，一步步拆开揉碎讲清楚。

确认密钥加载路径优先级

OpenClaw 只认两个位置的密钥配置，而且有严格优先级：

，它会覆盖所有其他配置；。如果你同时在这两个文件里写了 apiKey，网关只会用 openclaw.json 里的值，models.json 里的被完全忽略——但你可能还傻傻以为改那里就生效了。

先确认当前 Gateway 进程运行用户是谁：执行 ps -eo user,comm | grep openclaw-gateway，输出第一列就是用户。所有路径都必须基于该用户的家目录展开。比如 root 用户要改的是 /root/.openclaw/openclaw.json，而不是你的个人目录。

把 apiKey 替换成环境变量引用

打开 ~/.openclaw/openclaw.json，找到对应 provider（如 anthropic、openai）的配置段。

把原来写死的 apiKey 字段 "apiKey": "sk-abc123..." 改成 "apiKey": "${ANTHROPIC_API_KEY}"（注意双引号和花括号一个都不能少）。

这一步必须做，否则密钥会明文留在配置文件里。一旦误传 GitHub，API Key 立刻暴露，服务商会在几小时内冻结密钥并扣费——到时候哭都来不及。

创建 secrets.env 并注入 systemd

在用户家目录下新建文件：~/.openclaw/secrets.env，内容只写一行：ANTHROPIC_API_KEY=sk-your-real-key-here（不要加空格，不要换行，不要引号，干错利落）。

编辑 systemd 服务文件：sudo systemctl edit openclaw-gateway，插入以下内容：

[Service]
EnvironmentFile=/home/your-username/.openclaw/secrets.env

注意替换 your-username 为你实际的用户名，路径必须绝对且可读——如果填错路径，systemd 启动时根本不会报错，而是直接用空环境变量去请求 API，结果就是 401，你查半天也查不出原因。

保存后执行：sudo systemctl daemon-reload && sudo systemctl restart openclaw-gateway。

验证环境变量是否真正生效

方法一：查进程环境
运行 sudo cat /proc/$(pgrep -f 'openclaw-gateway')/environ | tr '' 'n' | grep ANTHROPIC_API_KEY，能看到完整密钥值才说明注入成功。如果没输出，说明 EnvironmentFile 路径错、权限不足、或服务没重启——一一排查。

方法二：用 status 命令直检
执行 openclaw models status，若返回 ✅ Anthropic: authenticated 就通过了；若显示 ❌ Anthropic: unauthorized，立刻回溯前几步，重点检查 secrets.env 文件权限是否为 600（chmod 600 ~/.openclaw/secrets.env）。

说到底，OpenClaw 的密钥配置就是个“文件路径 + 环境变量”的链路问题。只要路径写对、环境注入、权限放对，大概率一次搞定。别在没必要的地方纠结，按这个流程走，大概率能解决 90% 的报错。