Переменные окружения

OpenClaw получает переменные окружения из нескольких источников. Правило — никогда не переопределять существующие значения.

Приоритет (от наивысшего к низшему)

Окружение процесса (то, что процесс Gateway (шлюз) уже получил от родительской оболочки/демона).
.env в текущем рабочем каталоге (dotenv по умолчанию; не переопределяет).
Глобальный .env по адресу ~/.openclaw/.env (также известен как $OPENCLAW_STATE_DIR/.env; не переопределяет).
Блок Config env в ~/.openclaw/openclaw.json (применяется только при отсутствии значения).
Необязательный импорт login-shell (env.shellEnv.enabled или OPENCLAW_LOAD_SHELL_ENV=1), применяется только для отсутствующих ожидаемых ключей.

Если файл конфига полностью отсутствует, шаг 4 пропускается; импорт оболочки всё равно выполняется, если включён.

Блок Config `env`

Два эквивалентных способа установки inline env vars (оба являются непереходящими):

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

Импорт Shell env

env.shellEnv запускает вашу login-shell и импортирует только отсутствующие ожидаемые ключи:

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

Env var эквиваленты:

OPENCLAW_LOAD_SHELL_ENV=1
OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

Подстановка переменных окружения в конфиге

Вы можете напрямую ссылаться на переменные окружения в строковых значениях конфига, используя синтаксис ${VAR_NAME}:

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

Подробности см. в разделе Конфигурация: подстановка переменных окружения.