Help 导读

环境变量从哪里来、优先级怎么排

OpenClaw 从 5 个来源加载环境变量,优先级从进程环境到 shell 导入依次降低。核心规则是“绝不覆盖已存在的值”,所以先到者生效。最容易踩坑的是 `.env` 文件和配置 `env` 块都只能补缺,不能覆盖已有变量;如果你在 shell 里 export 了某个 key,后面所有来源的同名 key 都会被忽略。

先讲这一页到底在解决什么

环境变量从哪里来、优先级怎么排

OpenClaw 从 5 个来源加载环境变量,优先级从进程环境到 shell 导入依次降低。核心规则是“绝不覆盖已存在的值”,所以先到者生效。最容易踩坑的是 `.env` 文件和配置 `env` 块都只能补缺,不能覆盖已有变量;如果你在 shell 里 export 了某个 key,后面所有来源的同名 key 都会被忽略。

原文共 14 节,先看 Start Here 路径:/help/environment 查看官方原文

第一站

🏷 环境变量像门口的贴纸,不像代码本体

它们负责“配置氛围”,不是负责“写逻辑”。

🔑

密钥

像抽屉钥匙,不能随便贴在门上。

⚙️

开关

像把灯打开或关掉。

🧾

默认值

像先写好的备忘贴。

第二站

🛠 `.env` 和命令像在做什么

官方讲环境变量时,通常是在帮你把钥匙放进对的抽屉里。

`.env`

像家门口的小便签本。

`OPENCLAW_*`

像一排统一格式的贴纸,方便系统认。

别把 secret 写进代码

像别把家门钥匙刻在门板上。

最后记住

🎈 Environment 的关键,是“贴对地方”

钥匙、开关、默认值,放在环境变量里最稳。