ClawCN - OpenClaw 中文版

主题

环境变量 ​

OpenClaw 从多个来源获取环境变量。规则是永不覆盖现有值。

优先级(从高到低) ​

  1. 进程环境(Gateway 进程已经从父 shell/守护进程获得的环境变量)。
  2. 当前工作目录中的 .env(dotenv 默认;不覆盖)。
  3. 全局 .env,位于 ~/.openclaw/.env(即 $OPENCLAW_STATE_DIR/.env;不覆盖)。
  4. ~/.openclaw/openclaw.json 中的配置 env 块(仅在缺失时应用)。
  5. 可选的登录 shell 导入(env.shellEnv.enabled 或 OPENCLAW_LOAD_SHELL_ENV=1),仅对缺失的预期键应用。

如果配置文件完全缺失,则跳过第 4 步;如果启用,shell 导入仍会运行。

配置 env 块 ​

两种等效的内联环境变量设置方式(两者都不覆盖):

json5
{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
  },
}

Shell 环境导入 ​

env.shellEnv 运行您的登录 shell 并仅导入缺失的预期键:

json5
{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

等效的环境变量:

  • OPENCLAW_LOAD_SHELL_ENV=1
  • OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

配置中的环境变量替换 ​

您可以使用 ${VAR_NAME} 语法在配置字符串值中直接引用环境变量:

json5
{
  models: {
    providers: {
      "vercel-gateway": {
        apiKey: "${VERCEL_GATEWAY_API_KEY}",
      },
    },
  },
}

详细信息请参阅配置:环境变量替换。

相关内容 ​