跳转到内容

环境变量

环境变量

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

优先级（从高到低）

进程环境（Gateway(网关) 网关进程从父 shell/守护进程已获取的环境）。
当前工作目录中的 .env（dotenv 默认；不覆盖现有值）。
位于 ~/.openclaw/.env 的 全局 .env（又名 $OPENCLAW_STATE_DIR/.env；不覆盖现有值）。
~/.openclaw/openclaw.json 中的 Config env 块（仅在缺失时应用）。
可选的登录 shell 导入（env.shellEnv.enabled 或 OPENCLAW_LOAD_SHELL_ENV=1），仅针对缺失的预期键应用。

如果配置文件完全缺失，将跳过第 4 步；但如果启用，shell 导入仍会运行。

Config `env` 块

设置内联环境变量的两种等效方式（均为非覆盖式）：

{
  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

配置中的环境变量替换

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

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

请参阅配置：环境变量替换了解详情。

相关