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

¿Alguna vez has tenido problemas gestionando sesiones que se desconectan o procesos que se pelean por el mismo puerto? Configurar una arquitectura de red que funcione bien sin complicaciones innecesarias es un reto clásico cuando escalas tus herramientas. Aquí te explico cómo funciona el modelo de red para que tu configuración sea limpia y eficiente.

Modelo de Red

Este contenido se ha fusionado en Network. Consulta esa página para ver la guía actual.

La mayoría de las operaciones pasan por el Gateway (openclaw gateway), un único proceso de larga duración que gestiona las conexiones de los canales y el plano de control de WebSocket.

Reglas principales

• Te recomiendo usar un Gateway por host. Es el único proceso que tiene permiso para gestionar la sesión de WhatsApp Web. Si necesitas bots de rescate o un aislamiento estricto, ejecuta varios gateways con perfiles y puertos aislados. Mira Multiple gateways.
• Primero el loopback: el WS del Gateway usa por defecto ws://127.0.0.1:18789. El asistente genera un token de gateway por defecto, incluso para loopback. Para acceso vía tailnet, ejecuta openclaw gateway --bind tailnet --token ... porque los tokens son obligatorios para binds que no sean loopback.
• Los Nodes se conectan al WS del Gateway a través de LAN, tailnet o SSH según lo necesites. El bridge TCP antiguo está obsoleto.
• El host de Canvas se sirve mediante el servidor HTTP del Gateway en el mismo puerto que el Gateway (por defecto 18789):
  • /__openclaw__/canvas/
  • /__openclaw__/a2ui/ Cuando gateway.auth está configurado y el Gateway se vincula más allá del loopback, estas rutas están protegidas por la autenticación del Gateway. Los clientes Node usan URLs de capacidad con alcance de node vinculadas a su sesión de WS activa. Mira Gateway configuration (canvasHost, gateway).
• El uso remoto se hace normalmente mediante túnel SSH o VPN tailnet. Mira Remote access y Discovery.

AI Setup Assistant

Pasos siguientes

• Gateway configuration
• Remote access
• Discovery
• Multiple gateways