环境变量

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

优先级（最高 → 最低）

进程环境（网关进程从父 shell/守护进程已经拥有的内容）。
当前工作目录中的 .env（dotenv 默认；不覆盖）。
全局 .env 位于 ~/.clawdbot/.env（即 $CLAWDBOT_STATE_DIR/.env；不覆盖）。
配置 env 块 在 ~/.clawdbot/openclaw.json 中（仅在缺失时应用）。
可选的登录 shell 导入（env.shellEnv.enabled 或 CLAWDBOT_LOAD_SHELL_ENV=1），仅对缺失的预期密钥应用。

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

两种等效的设置内联环境变量的方式（两者都不覆盖）：

json5

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

env.shellEnv 运行您的登录 shell 并仅导入缺失的预期密钥：

json5

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

等效环境变量：

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

json5

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

有关完整详细信息，请参阅配置：环境变量替换。