Skip to main content

Múltiples Gateways (mismo host)

La mayoría de las configuraciones deberían usar un solo Gateway porque un único Gateway puede manejar múltiples conexiones de mensajería y agentes. Si necesita un aislamiento o redundancia más fuertes (p. ej., un bot de rescate), ejecute Gateways separados con perfiles/puertos aislados.

Lista de verificación de aislamiento (obligatoria)

  • OPENCLAW_CONFIG_PATH — archivo de configuración por instancia
  • OPENCLAW_STATE_DIR — sesiones, credenciales y cachés por instancia
  • agents.defaults.workspace — raíz del espacio de trabajo por instancia
  • gateway.port (o --port) — único por instancia
  • Los puertos derivados (navegador/canvas) no deben superponerse
Si estos se comparten, encontrará carreras de configuración y conflictos de puertos.

Recomendado: perfiles (--profile)

Los perfiles delimitan automáticamente OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH y agregan un sufijo a los nombres de los servicios.
Servicios por perfil:

Guía de bot de rescate

Ejecute un segundo Gateway en el mismo host con sus propios:
  • perfil/configuración
  • directorio de estado
  • espacio de trabajo
  • puerto base (más puertos derivados)
Esto mantiene el bot de rescate aislado del bot principal para que pueda depurar o aplicar cambios de configuración si el bot principal está caído. Separación de puertos: deje al menos 20 puertos entre los puertos base para que los puertos derivados de navegador/canvas/CDP nunca colisionen.

Cómo instalar (bot de rescate)

Mapeo de puertos (derivados)

Puerto base = gateway.port (o OPENCLAW_GATEWAY_PORT / --port).
  • puerto del servicio de control del navegador = base + 2 (solo loopback)
  • el host de canvas se sirve en el servidor HTTP del Gateway (mismo puerto que gateway.port)
  • Los puertos CDP del perfil del navegador se asignan automáticamente desde browser.controlPort + 9 .. + 108
Si sobrescribe cualquiera de estos en la configuración o en variables de entorno, debe mantenerlos únicos por instancia.

Notas sobre Navegador/CDP (error común)

  • No fije browser.cdpUrl a los mismos valores en múltiples instancias.
  • Cada instancia necesita su propio puerto de control del navegador y su propio rango CDP (derivado de su puerto del Gateway).
  • Si necesita puertos CDP explícitos, configure browser.profiles.<name>.cdpPort por instancia.
  • Chrome remoto: use browser.profiles.<name>.cdpUrl (por perfil, por instancia).

Ejemplo manual de env

Comprobaciones rápidas