Configura variables de entorno en OpenClaw: Guía rápida

Gestionar variables de entorno suele ser un proceso frustrante. Configuras una API Key, todo parece funcionar en tu terminal, pero en cuanto pasas a producción o ejecutas un servicio en segundo plano, las variables parecen esfumarse.

OpenClaw tiene una forma clara de manejar esto para que no pierdas tiempo depurando rutas y puedas centrarte en lo que importa.

Variables de Entorno

Cómo OpenClaw carga y gestiona las variables de entorno.

---

¿Cómo carga OpenClaw las variables de entorno?

OpenClaw lee las variables de entorno del proceso padre (shell, launchd/systemd, CI, etc.) y además carga:

• .env desde el directorio de trabajo actual
• Un .env global de respaldo en ~/.openclaw/.env (también conocido como $OPENCLAW_STATE_DIR/.env)

Ninguno de estos archivos .env sobrescribe las variables de entorno existentes.

También puedes definir variables de entorno integradas en la configuración (se aplican solo si faltan en el entorno del proceso):

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

---

“Inicié el Gateway mediante el servicio y mis variables de entorno desaparecieron”. ¿Y ahora qué?

Dos soluciones comunes:

1. Pon las claves que faltan en ~/.openclaw/.env para que se detecten incluso si el servicio no hereda el entorno de tu shell.

2. Activa la importación de la shell (una opción cómoda):

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

Esto ejecuta tu shell de inicio de sesión e importa solo las claves esperadas que falten (nunca sobrescribe). Equivalentes en variables de entorno: OPENCLAW_LOAD_SHELL_ENV=1, OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000.

---

Configuré COPILOT_GITHUB_TOKEN, pero el estado de los modelos muestra “Shell env: off”. ¿Por qué?

openclaw models status informa si la importación del entorno de la shell está activada. “Shell env: off” no significa que falten tus variables de entorno; solo significa que OpenClaw no cargará tu shell de inicio de sesión automáticamente.

Si el Gateway se ejecuta como un servicio (launchd/systemd), no heredará el entorno de tu shell.

Soluciónalo haciendo una de estas acciones:

1. Pon el token en ~/.openclaw/.env
2. Activa la importación de la shell (env.shellEnv.enabled: true)
3. Añádelo al bloque env de tu configuración

Después, reinicia el Gateway:

openclaw gateway restart
openclaw models status

Los tokens de Copilot se leen de COPILOT_GITHUB_TOKEN (también GH_TOKEN / GITHUB_TOKEN).

Siguientes pasos

• Configuración del Gateway
• Gestión de Modelos

AI Setup Assistant