OpenClaw 能否稳定调用模型，很多时候不是界面设置问题，而是环境变量没有规划好。API Key 放在哪里、模型服务地址怎么写、不同环境如何区分、多人协作时如何避免密钥泄露，这些配置如果前期随手处理，后面排查起来会非常麻烦。
一、先分清哪些配置适合放进环境变量
环境变量适合保存会随部署环境变化、又不应该直接写进代码仓库的内容。OpenClaw 常见配置可以分为模型调用凭据、服务地址参数和运行控制参数。模型凭据包括 API Key、Secret、Token；服务地址包括 Base URL、兼容接口地址；运行参数包括超时时间、日志级别和并发数量。
把敏感配置从代码里拆出来的好处很直接：本地测试、测试服务器和正式服务器可以使用不同值，升级或迁移时也不需要大面积改代码。
二、准备环境变量清单
配置前先整理一份清单，避免今天加一个、明天补一个，最后没人知道哪个变量还在使用。清单至少包含变量名、用途、适用环境、来源和负责人。变量名建议统一使用大写和下划线，例如 OPENCLAW_MODEL_API_KEY、OPENCLAW_MODEL_BASE_URL、OPENCLAW_REQUEST_TIMEOUT。
三、本地和服务器怎么配置
本地调试可以使用系统环境变量，也可以使用项目支持的本地环境配置文件。更推荐把本地密钥放在不进入版本库的文件中，并确认 .gitignore 已经排除该文件。服务器上运行 OpenClaw 时，可以把环境变量写入服务管理配置、面板环境变量区域或容器运行参数中。
OPENCLAW_MODEL_API_KEY=sk-your-key
OPENCLAW_MODEL_BASE_URL=https://api.example.com/v1
OPENCLAW_MODEL_NAME=example-model
OPENCLAW_REQUEST_TIMEOUT=60
OPENCLAW_LOG_LEVEL=info四、配置后如何验证
- 重启 OpenClaw 服务，确认新变量被读取。
- 进入模型配置或测试调用页面。
- 发送一个短问题，观察是否有正常响应。
- 查看日志中是否出现认证失败、地址错误或超时提示。
- 切换一个小任务，确认连续调用稳定。
五、安全存放建议
API Key 不应放进截图、公开文章、代码仓库、前端页面、浏览器控制台输出和聊天记录。多人协作时，建议按角色分配权限，不要所有人共用最高权限密钥。如果怀疑密钥已经泄露，应立即撤销旧密钥，重新生成新密钥，并检查近期调用记录。
六、常见问题
环境变量改了为什么没有生效？ 多数情况下是服务没有重启，或变量写在了错误的运行环境里。
API Key 可以写在配置文件里吗？ 可以写在不进入版本库、权限受控的本地配置文件中，不建议写入公开代码。
测试环境和正式环境可以共用密钥吗？ 不建议。分开密钥更容易定位问题，也能降低误操作影响范围。
