Configura OpenClaw: Puertos, Acceso Remoto y Gateway

A veces, configurar la comunicación entre servicios se siente como un rompecabezas donde las piezas simplemente no encajan. Lidiar con conflictos de puertos o problemas de conectividad remota es una molestia común que todos hemos enfrentado al intentar desplegar nuestras aplicaciones.

Con OpenClaw Gateway, gestionar el acceso remoto y la configuración de puertos es directo. Esta guía te ayudará a configurar tu OpenClaw Gateway para que la comunicación entre tu API y tus servicios sea fluida y segura.

¿Cuáles son los puertos predeterminados del Gateway?

El Gateway utiliza puertos específicos para manejar el tráfico de red y la comunicación interna.

Puerto	Uso
18789	HTTP/WS (puerto principal)
18790	gRPC (RPC interno)

En modo remoto, utilizas el puerto 18789 (o el que hayas configurado) tanto para la Control UI como para el Gateway WebSocket.

¿Por qué aparece que el Gateway ya está en ejecución?

Es probable que otro proceso o un proceso “zombie” anterior esté ocupando los puertos 18789 o 18790.

# Check if the daemon is alive
openclaw gateway status

# Stop the service
openclaw gateway stop

# If you forcibly need the port
lsof -i :18789
kill -9 <pid>

¿Cómo uso la CLI en modo remoto?

Puedes añadir --remote <gateway-url> a tus comandos de CLI, o definir la variable OPENCLAW_GATEWAY_URL o la opción correspondiente en tu configuración.

Ejemplo:

openclaw status --remote http://my-vps-tailnet:18789

Si el Gateway utiliza autenticación por token, asegúrate también de configurar OPENCLAW_GATEWAY_TOKEN o usar el flag --token.

¿Puedo enlazar el Gateway a una dirección de Tailnet?

Sí, puedes hacerlo configurando gateway.bind: "tailnet". OpenClaw detecta automáticamente tu dirección 100.x.x.x de Tailscale y se enlaza a ella. Recuerda que también debes configurar gateway.auth.

Si Tailscale no está activo o no tiene una IP asignada, el Gateway no iniciará. El error suele ser similar a este:

Failed to bind to tailnet: no Tailscale IP found

Solución:

1. Inicia Tailscale en ese host (para que tenga una dirección 100.x).
2. Cambia a gateway.bind: "loopback" o "lan".

¿Puedo ejecutar múltiples Gateways en el mismo host?

Por lo general, no es necesario. Un solo Gateway puede gestionar múltiples canales de mensajería y agentes. Utiliza múltiples Gateways solo si necesitas redundancia (como un bot de rescate) o un aislamiento estricto.

Si realmente necesitas hacerlo, asegúrate de aislar lo siguiente:

1. Puertos diferentes para cada Gateway.
2. Directorios de estado distintos (OPENCLAW_STATE_DIR).
3. Nombres de servicio diferentes (archivo de unidad personalizado).
4. Rutas de credenciales distintas para evitar colisiones.

¿Cómo habilito la administración remota (no loopback)?

Los enlaces que no son de tipo loopback requieren autenticación obligatoria. Configura gateway.bind y gateway.auth en tu archivo de configuración:

{
  gateway: {
    bind: "lan",     // or "tailnet" for Tailscale-only
    port: 18789,
    auth: {
      mode: "token",
      token: "replace-me-with-a-strong-token"
    }
  }
}

Alternativa: Usa Tailscale Serve:

openclaw gateway --tailscale serve

¿Por qué el Gateway está escuchando pero la Control UI no carga?

Verifica los siguientes puntos para descartar errores comunes:

1. Estás usando http:// y el nombre de host junto con el puerto correctos.
2. Tu navegador puede alcanzar esa dirección (revisa firewall, Tailscale o VPN).
3. La autenticación del Gateway está configurada y tienes el token correcto.

Ejecuta openclaw gateway status en el host del Gateway para confirmar que está activo. Si es así, intenta hacer un curl al endpoint de salud:

curl http://localhost:18789/health

Si necesitas más ayuda, consulta nuestro AI Setup Assistant.

Siguientes pasos

• Configuración de autenticación
• Guía de despliegue en Docker