Configura OpenClaw en macOS: Guía de instalación rápida

Configurar servicios en segundo plano suele ser una tarea tediosa que interrumpe tu flujo de trabajo. Si buscas una forma de que tu entorno sea estable sin intervención manual constante, gestionar el Gateway mediante launchd es el camino correcto para mantener todo bajo control.

OpenClaw.app ya no incluye Node/Bun ni el runtime del Gateway. La app de macOS espera una instalación externa de la CLI openclaw. No inicia el Gateway como un proceso hijo, sino que gestiona un servicio launchd por usuario para mantener el Gateway activo o se conecta a un Gateway local que ya esté funcionando.

Instalar la CLI (requerido para el modo local)

Node 24 es el runtime por defecto en Mac. Node 22 LTS, actualmente 22.14+, todavía funciona para mantener la compatibilidad. Instala openclaw de forma global:

npm install -g openclaw@<version>

El botón Install CLI de la app de macOS ejecuta este mismo proceso mediante npm/pnpm (no te recomiendo usar bun para el runtime del Gateway).

Launchd (Gateway como LaunchAgent)

Etiqueta (Label):

• ai.openclaw.gateway (o ai.openclaw.<profile>; es posible que las etiquetas antiguas com.openclaw.* se mantengan)

Ubicación del Plist (por usuario):

• ~/Library/LaunchAgents/ai.openclaw.gateway.plist (o ~/Library/LaunchAgents/ai.openclaw.<profile>.plist)

Gestión:

• La app de macOS controla la instalación y actualización del LaunchAgent en modo Local.
• También puedes instalarlo con la CLI: openclaw gateway install.

Comportamiento:

• “OpenClaw Active” activa o desactiva el LaunchAgent.
• Cerrar la app no detiene el gateway (launchd lo mantiene vivo).
• Si ya hay un Gateway funcionando en el puerto configurado, la app se conecta a él en lugar de iniciar uno nuevo.
• Los registros de launchd stdout/err se encuentran en: /tmp/openclaw/openclaw-gateway.log.

Compatibilidad de versiones

La app de macOS verifica la versión del gateway comparándola con su propia versión. Si detectas que son incompatibles, actualiza la CLI global para que coincida con la versión de la app.

Prueba rápida (Smoke check)

openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback

Después ejecuta:

openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

AI Setup Assistant

Pasos siguientes

• Configuración de perfiles
• Solución de problemas de conexión