Configura Remote OpenClaw: Controla tu Gateway desde macOS

Configurar todo en tu máquina local es genial hasta que necesitas que el sistema sea permanente. Gestionar manualmente túneles SSH o intentar sincronizar configuraciones entre tu laptop y un servidor remoto suele ser un dolor de cabeza. Quieres la comodidad de la interfaz de macOS, pero con la potencia de ejecución de un host dedicado.

Mover tu OpenClaw Gateway a un servidor remoto te permite mantener los procesos activos sin depender de que tu laptop esté encendida, manteniendo el control total desde la app de escritorio.

Requisitos previos

Para que esto funcione, asegúrate de cumplir con estos requisitos en tu host remoto:

1. Node + pnpm instalados para construir e instalar la OpenClaw CLI (pnpm install && pnpm build && pnpm link --global).
2. La CLI openclaw debe estar disponible en el PATH para shells no interactivas (usa symlinks en /usr/local/bin si es necesario).
3. Acceso SSH mediante autenticación por llave (se recomiendan IPs de Tailscale para mayor estabilidad).
4. Permisos TCC aprobados en el host remoto (Microphone, Accessibility, etc.) ejecutando el onboarding en esa máquina.

Inicio rápido

Sigue estos pasos para conectar tu app de macOS con el host remoto en menos de 5 minutos:

1. Abre Settings → General en la app de macOS.
2. En la sección OpenClaw runs, selecciona Remote over SSH.
3. Configura el Transport: elige SSH tunnel (por defecto) o Direct (ws/wss).
4. Define el SSH target con el formato user@host. Si el Gateway está en tu LAN y usa Bonjour, aparecerá en la lista para auto-completar.
5. Si usas el modo Direct, introduce la Gateway URL (ej. wss://gateway.example.ts.net).
6. Haz clic en Test remote. Si todo está bien, la app confirmará que openclaw status --json responde correctamente.

Una vez configurado, los health checks y el Web Chat funcionarán automáticamente a través de esta conexión.

WhatsApp login flow (remote)

Para vincular tu cuenta, no lo hagas desde la app local. Debes ejecutar el comando directamente en el servidor remoto:

1. Ejecuta openclaw channels login --verbose en el host remoto.
2. Escanea el código QR con tu teléfono.
3. Si la sesión expira, repite este proceso en el host.

Notification sounds

Puedes personalizar los sonidos de las notificaciones enviando comandos desde el host remoto:

openclaw nodes notify --node \<id\> --title "Ping" --body "Remote gateway ready" --sound Glass

Recuerda que ya no existe un interruptor global de “sonido por defecto”; tú eliges el sonido en cada petición.

Solución de problemas

Si algo falla, revisa estos problemas comunes extraídos de la documentación:

• exit 127 / not found: La CLI openclaw no está en el PATH de shells que no son de login. Añádela a /etc/paths o crea un symlink en /usr/local/bin o /opt/homebrew/bin.
• Health probe failed: Revisa la conectividad SSH, el PATH y verifica que Baileys tenga la sesión iniciada con openclaw status --json.
• Web Chat stuck: Confirma que el Gateway está corriendo en el host remoto y que el puerto reenviado coincide con el puerto WebSocket del Gateway.
• Node IP shows 127.0.0.1: Es el comportamiento normal al usar SSH tunnel. Si necesitas ver la IP real del cliente, cambia el Transport a Direct (ws/wss).

AI Setup Assistant

Próximos pasos

• Security
• Tailscale