La mayoría de las operaciones pasan a través del Gateway (openclaw gateway), un único proceso de larga ejecución que gestiona las conexiones de los canales y el plano de control WebSocket.
Reglas principales
- Se recomienda un Gateway por host. Es el único proceso autorizado a mantener la sesión de WhatsApp Web. Para bots de rescate o aislamiento estricto, ejecuta múltiples gateways con perfiles y puertos aislados. Consulta Múltiples gateways.
- Loopback primero: el WS del Gateway se enlaza por defecto a
ws://127.0.0.1:18789. El asistente de configuración genera un token de gateway por defecto, incluso para loopback. Para acceso por tailnet, ejecutaopenclaw gateway --bind tailnet --token ...ya que los tokens son obligatorios para enlaces no-loopback. - Los nodos se conectan al WS del Gateway a través de LAN, tailnet o SSH según sea necesario. El puente TCP heredado está obsoleto.
- El canvas host es servido por el servidor HTTP del Gateway en el mismo puerto que el Gateway (por defecto
18789):/__openclaw__/canvas//__openclaw__/a2ui/Cuandogateway.authestá configurado y el Gateway se enlaza más allá del loopback, estas rutas están protegidas por la autenticación del Gateway. Los clientes de nodo usan URLs de capacidad con alcance de nodo vinculadas a su sesión WS activa. Consulta Configuración del Gateway (canvasHost,gateway).
- El uso remoto normalmente se hace mediante túnel SSH o VPN tailnet. Consulta Acceso remoto y Descubrimiento.