Variables de entorno

OpenClaw extrae variables de entorno de múltiples fuentes. La regla es nunca sobrescribir los valores existentes.

Precedencia (más alta → más baja)

Entorno de proceso (lo que el proceso del Gateway ya tiene del shell/demonio principal).
.env en el directorio de trabajo actual (dotenv por defecto; no sobrescribe).
.env global en ~/.openclaw/.env (también conocido como $OPENCLAW_STATE_DIR/.env; no sobrescribe).
Bloque env de configuración en ~/.openclaw/openclaw.json (se aplica solo si falta).
Importación opcional del shell de inicio de sesión (env.shellEnv.enabled o OPENCLAW_LOAD_SHELL_ENV=1), aplicada solo para las claves esperadas que faltan.

Si falta el archivo de configuración por completo, se omite el paso 4; la importación del shell aún se ejecuta si está habilitada.

Dos formas equivalentes de establecer variables de entorno en línea (ambas no sobrescriben):

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

env.shellEnv ejecuta tu shell de inicio de sesión e importa solo las claves esperadas que faltan:

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

Equivalentes de variables de entorno:

Puedes hacer referencia a variables de entorno directamente en los valores de cadena de la configuración usando la sintaxis ${VAR_NAME}:

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