OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Gateway

Varios gateways

La mayoría de las configuraciones necesitan un solo Gateway: un único Gateway gestiona múltiples conexiones de mensajería y agentes. Ejecute Gateways independientes con perfiles y puertos aislados únicamente cuando necesite mayor aislamiento o redundancia (por ejemplo, un bot de rescate).

Inicio rápido del bot de rescate

La configuración más sencilla de un bot de rescate:

  • Mantenga el bot principal en el perfil predeterminado.
  • Ejecute el bot de rescate en --profile rescue, con su propio token de bot de Telegram.
  • Asigne al bot de rescate un puerto base diferente, por ejemplo, 19789.

Esto permite que el bot de rescate pueda depurar o aplicar cambios de configuración si el bot principal no está disponible. Deje al menos 20 puertos entre los puertos base para que los puertos derivados del navegador/CDP nunca entren en conflicto.

bash
# Bot de rescate (bot de Telegram independiente, perfil independiente, puerto 19789)openclaw --profile rescue onboardopenclaw --profile rescue gateway install --port 19789

Si el bot principal ya está en ejecución, normalmente eso es todo lo que necesita. Si la incorporación ya instaló el servicio de rescate, omita el último gateway install.

Durante openclaw --profile rescue onboard:

  • Use un token de bot de Telegram independiente, dedicado a la cuenta de rescate (fácil de mantener solo para operadores, independiente de la instalación del canal o la aplicación del bot principal y una vía de recuperación sencilla mediante mensajes directos).
  • Mantenga el nombre de perfil rescue.
  • Use un puerto base al menos 20 números superior al del bot principal.
  • Acepte el espacio de trabajo de rescate predeterminado, salvo que ya gestione uno por su cuenta.

Qué cambia --profile rescue onboard

--profile rescue onboard ejecuta el flujo normal de incorporación, pero escribe todo en un perfil independiente, por lo que el bot de rescate obtiene sus propios elementos:

  • Archivo de perfil/configuración
  • Directorio de estado
  • Espacio de trabajo (predeterminado: ~/.openclaw/workspace-rescue)
  • Nombre del servicio administrado
  • Puerto base (más los puertos derivados)
  • Token de bot de Telegram

Por lo demás, las indicaciones son idénticas a las de la incorporación normal.

Configuración general de múltiples Gateways

El mismo patrón de aislamiento funciona para cualquier par o grupo de Gateways en un host: asigne a cada Gateway adicional su propio perfil con nombre y puerto base:

bash
# principal (perfil predeterminado)openclaw setupopenclaw gateway --port 18789 # gateway adicionalopenclaw --profile ops setupopenclaw --profile ops gateway --port 19789

También se pueden usar perfiles con nombre en ambos casos:

bash
openclaw --profile main setupopenclaw --profile main gateway --port 18789 openclaw --profile ops setupopenclaw --profile ops gateway --port 19789

Los servicios siguen el mismo patrón:

bash
openclaw gateway installopenclaw --profile ops gateway install --port 19789

Use el inicio rápido del bot de rescate para disponer de una vía de operador alternativa; use el patrón general de perfiles para varios Gateways de larga duración en distintos canales, inquilinos, espacios de trabajo o roles operativos.

Lista de comprobación del aislamiento

Mantenga estos valores únicos para cada instancia de Gateway:

Configuración Propósito
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
Puertos derivados del navegador/CDP Consulte más adelante

Compartir cualquiera de estos elementos provoca conflictos de configuración, estado o puertos. El inicio del Gateway impone la propiedad exclusiva del directorio de estado incluso cuando OPENCLAW_ALLOW_MULTI_GATEWAY=1 omite la instancia única por configuración.

Asignación de puertos (derivados)

Puerto base = gateway.port (o OPENCLAW_GATEWAY_PORT / --port).

  • Puerto del servicio de control del navegador = base + 2 (solo bucle local).
  • El host de Canvas se sirve en el propio servidor HTTP del Gateway (el mismo puerto que gateway.port).
  • Los puertos CDP del perfil del navegador se asignan automáticamente desde browser control port + 9 hasta + 108.

Si sobrescribe cualquiera de estos valores en la configuración o el entorno, debe mantenerlos únicos para cada instancia.

Notas sobre el navegador/CDP (error frecuente)

  • No fije browser.cdpUrl al mismo valor en varias instancias.
  • Cada instancia necesita su propio puerto de control del navegador y su propio intervalo de CDP (derivados de su puerto de Gateway).
  • Para puertos CDP explícitos, establezca browser.profiles.<name>.cdpPort por instancia.
  • Para Chrome remoto, use browser.profiles.<name>.cdpUrl (por perfil y por instancia).

Ejemplo manual con variables de entorno

bash
OPENCLAW_CONFIG_PATH=~/.openclaw/main.json \OPENCLAW_STATE_DIR=~/.openclaw \openclaw gateway --port 18789 OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \OPENCLAW_STATE_DIR=~/.openclaw-rescue \openclaw gateway --port 19789

Comprobaciones rápidas

bash
openclaw gateway status --deepopenclaw --profile rescue gateway status --deepopenclaw --profile rescue gateway probeopenclaw statusopenclaw --profile rescue statusopenclaw --profile rescue browser status
  • gateway status --deep detecta servicios launchd/systemd/schtasks obsoletos de instalaciones anteriores.
  • El texto de advertencia de gateway probe, como multiple reachable gateway identities detected, solo se espera cuando se ejecuta intencionadamente más de un gateway aislado o cuando OpenClaw no puede demostrar que los destinos de sondeo accesibles corresponden al mismo gateway. Un túnel SSH, una URL de proxy o una URL remota configurada hacia el mismo gateway constituyen un solo gateway con varios transportes, aunque los puertos de transporte sean diferentes.

Contenido relacionado

Was this useful?
On this page

On this page