OpenClaw是一款开源的智能助手框架，支持接入多种大模型服务。要让它正常工作，第一步就是把自己的API Key配置进去，否则程序无法调用模型接口，运行时会直接报错提示鉴权失败。下面我们从头到尾把这件事讲清楚。
添加API Key前的准备工作
在动手配置之前，你需要先拿到一个有效的API Key。以OpenAI为例，登录官方平台后进入API Keys管理页面，点击创建新Key，系统会生成一串以sk开头的密钥。这串密钥只在创建时完整显示一次，务必当场复制保存到安全的地方，页面刷新后就再也看不到了。
除了OpenAI，OpenClaw也支持Anthropic、DeepSeek、通义千问、智谱等多家服务商的模型。不同平台的Key申请流程大同小异，都是在对应官网的控制台里创建。需要注意的是，大部分平台要求账户里有一定的余额或额度，Key本身没有余额时，即使配置正确也会调用失败。
另外要提醒一点，API Key等同于账户的钥匙，泄露出去别人就能用你的额度消费。不要把Key直接提交到Git仓库，也不要在公开场合粘贴明文，推荐使用环境变量或者本地配置文件来保存，并把这些文件加入版本控制的忽略列表。
通过环境变量方式配置API Key
环境变量是最推荐的方式，安全性高，而且不依赖具体的项目目录。OpenClaw默认会读取系统环境变量中的密钥信息，比如OpenAI的Key对应的环境变量名是OPENAI_API_KEY，Anthropic对应的是ANTHROPIC_API_KEY，其他服务商也遵循类似的命名规则。
在Linux或macOS系统上，可以打开终端执行export命令临时设置，也可以写入shell配置文件让它永久生效：
# 临时生效，关闭终端后失效 export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx # 永久生效，写入配置文件后执行source echo 'export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx' >> ~/.bashrc source ~/.bashrc # macOS使用zsh的用户写入这个文件 echo 'export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx' >> ~/.zshrc source ~/.zshrc
Windows用户可以通过图形界面设置：右键此电脑选择属性，进入高级系统设置，点击环境变量，在用户变量中新建一条记录，变量名填OPENAI_API_KEY，变量值填你的Key，保存后重新打开命令行窗口即可生效。也可以在PowerShell中执行如下命令：
# 仅当前会话有效 $env:OPENAI_API_KEY = "sk-xxxxxxxxxxxxxxxx" # 永久写入用户环境变量 setx OPENAI_API_KEY "sk-xxxxxxxxxxxxxxxx"
设置完成后，可以在终端里用echo命令验证一下环境变量是否已经生效。如果输出的是你设置的Key，说明配置成功，此时启动OpenClaw就能自动读取到密钥了。
通过配置文件方式添加Key
如果你觉得环境变量管理起来麻烦，也可以直接在OpenClaw的配置文件里填写Key。OpenClaw安装后会在用户主目录下生成配置文件，通常位于 ~/.openclaw/ 目录中，文件名一般是配置相关的json或yaml格式。用任意文本编辑器打开它，找到模型服务商的配置节点，填入你的Key即可。
一个典型的配置结构大致如下，不同版本字段名可能略有差异，以你本地的实际文件为准：
{
"providers": {
"openai": {
"apiKey": "sk-xxxxxxxxxxxxxxxx",
"model": "gpt-4o"
},
"anthropic": {
"apiKey": "sk-ant-xxxxxxxxxxxxxxxx",
"model": "claude-sonnet-4"
}
},
"defaultProvider": "openai"
}
修改配置文件时要注意两点：一是JSON格式对语法要求严格，多余的逗号或者漏掉的引号都会导致解析失败，程序启动时会报配置错误；二是文件保存后一般需要重启OpenClaw服务，新的Key才会被加载。部分版本还支持在项目目录下放置env文件，格式为每行一个KEY=VALUE，程序启动时自动读取，这种方式配合.gitignore使用也很方便：
# .env 文件内容示例 OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx # 别忘了在.gitignore中添加 # .env
如果OpenClaw带有Web管理界面，部分版本还支持在界面的设置页面中直接填写和保存Key，改动即时生效，适合不喜欢命令行的用户。具体入口一般在设置或者模型配置菜单下。
Key配置不生效的常见排查方法
配置完成后如果仍然提示鉴权失败或者找不到Key，可以从以下几个方面逐一排查。首先是环境变量没有生效，这种情况最常见，尤其是Windows用户设置完setx后没有重新打开终端窗口，旧窗口里读到的还是空值。重新开一个命令行窗口再测试即可。
其次是Key本身的问题。检查一下是否复制完整，有没有多复制了空格或者少复制了末尾字符；确认Key对应的服务商和你配置的字段是否匹配，比如把Anthropic的Key填到了OpenAI的配置项里肯定是不行的；还要确认账户余额充足、Key没有被删除或禁用。
第三是网络问题。国内用户访问OpenAI等海外接口时，直连通常会超时，需要配置代理。OpenClaw一般支持通过环境变量设置代理地址：
# 设置HTTP代理 export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890
如果使用DeepSeek、通义千问这类国内服务商的接口，则不存在网络问题，但要注意配置文件中接口地址baseURL字段是否填写正确，官方文档里都会给出准确的接口地址。最后，如果以上都没问题，可以打开OpenClaw的调试日志模式，查看具体的报错信息，日志中通常会明确指出是Key无效、额度不足还是网络超时，对症处理即可。
多Key切换与安全性管理建议
当你同时使用多家模型服务，或者有测试和正式两套Key时，可以在配置文件中同时填写多个服务商的信息，通过defaultProvider字段或者运行时参数切换默认使用的模型，不需要反复修改Key本身。
安全性方面再强调几点实践经验：定期轮换Key，发现异常消费立即去平台后台吊销重建；给Key设置消费限额，很多平台支持按月设置额度上限，可以避免意外损失；团队协作场景下不要共享同一个Key，每人独立申请便于审计和追责。做好这几点，OpenClaw就能稳定安全地为你服务了。如果在配置过程中遇到其他问题，也可以去项目的GitHub仓库查阅文档或提交Issue，社区响应通常比较及时。