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, ejecuta openclaw 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/ Cuando gateway.auth está 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.