跳轉到主要內容

​
環境變數

OpenClaw pulls environment variables from multiple sources. The rule is never override existing values.

​
優先順序（最高 → 最低）

  1. 程序環境（Gateway 閘道器 程序已從父層 shell／daemon 取得的值）。
  2. 目前工作目錄中的 .env（dotenv 預設；不會覆寫）。
  3. 位於 ~/.openclaw/.env 的全域 .env（亦稱為 $OPENCLAW_STATE_DIR/.env；不會覆寫）。
  4. ~/.openclaw/openclaw.json 中的設定 env 區塊（僅在缺少時套用）。
  5. 選用的登入 shell 匯入（env.shellEnv.enabled 或 OPENCLAW_LOAD_SHELL_ENV=1），僅針對缺少的預期金鑰套用。
如果設定檔完全缺失，則會跳過步驟 4；若啟用，Shell 匯入仍會執行。

​
設定檔 env 區塊

Two equivalent ways to set inline env vars (both are non-overriding): 
{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
  },
}

​
Shell 環境匯入

env.shellEnv 會執行你的登入 shell，並僅匯入 缺少 的預期金鑰： 
{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}
環境變數對應：
  • OPENCLAW_LOAD_SHELL_ENV=1
  • OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

​
Env var substitution in config

你可以在設定的字串值中，使用 ${VAR_NAME} 語法直接參考環境變數： 
{
  models: {
    providers: {
      "vercel-gateway": {
        apiKey: "${VERCEL_GATEWAY_API_KEY}",
      },
    },
  },
}
完整細節請參閱［Configuration: Env var substitution］(/gateway/configuration#env-var-substitution-in-config)。
變數目的
OPENCLAW_HOMEOverride the home directory used for all internal path resolution (~/.openclaw/, agent dirs, sessions, credentials). Useful when running OpenClaw as a dedicated service user.
OPENCLAW_STATE_DIROverride the state directory (default ~/.openclaw).
OPENCLAW_CONFIG_PATH覆寫設定檔路徑（預設為 ~/.openclaw/openclaw.json）。

​
OPENCLAW_HOME

設定後，OPENCLAW_HOME 會取代系統家目錄（$HOME / os.homedir()）以進行所有內部路徑解析。 4. 這可為無頭服務帳號啟用完整的檔案系統隔離。 優先順序： OPENCLAW_HOME > $HOME > USERPROFILE > os.homedir() 範例（macOS LaunchDaemon）： 
7. <key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_HOME</key>
  <string>/Users/kira</string>
</dict>
OPENCLAW_HOME 也可以設定為波浪號路徑（例如 ~/svc），在使用前會先以 $HOME 展開。

​
12. 相關