文档
环境变量

环境变量

适用范围

使用本页面当：

  • 您需要知道加载了哪些环境变量以及按什么顺序
  • 您正在调试网关中缺失的 API 密钥
  • 您正在记录提供程序身份验证或部署环境

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

优先级（从高到低）

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

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

配置 env 块

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

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

Shell 环境导入

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

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

环境变量等效项：

  • MOLTBOT_LOAD_SHELL_ENV=1
  • MOLTBOT_SHELL_ENV_TIMEOUT_MS=15000

配置中的环境变量替换

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

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

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

相关

广播群组脚本