Skip to main content

Mehrere Gateways (gleicher Host)

Die meisten Setups sollten einen Gateway verwenden, da ein einzelner Gateway mehrere Messaging-Verbindungen und Agenten verarbeiten kann. Wenn Sie stärkere Isolation oder Redundanz benötigen (z. B. einen Rettungs-Bot), betreiben Sie separate Gateways mit isolierten Profilen/Ports.

Isolations-Checkliste (erforderlich)

  • OPENCLAW_CONFIG_PATH — Konfigurationsdatei pro Instanz
  • OPENCLAW_STATE_DIR — Sitzungen, Zugangsdaten, Caches pro Instanz
  • agents.defaults.workspace — Workspace-Root pro Instanz
  • gateway.port (oder --port) — pro Instanz eindeutig
  • Abgeleitete Ports (Browser/Canvas) dürfen sich nicht überschneiden
Wenn diese geteilt werden, treten Konfigurations-Race-Conditions und Portkonflikte auf.

Empfohlen: Profile (--profile)

Profile grenzen OPENCLAW_STATE_DIR + OPENCLAW_CONFIG_PATH automatisch ein und versehen Servicenamen mit Suffixen.
Services pro Profil:

Leitfaden für Rettungs-Bots

Betreiben Sie einen zweiten Gateway auf demselben Host mit jeweils eigener:
  • Profil/Konfiguration
  • state Verzeichnis
  • Workspace
  • Basis-Port (plus abgeleitete Ports)
So bleibt der Rettungs-Bot vom Haupt-Bot isoliert und kann debuggen oder Konfigurationsänderungen anwenden, falls der primäre Bot ausfällt. Portabstand: Lassen Sie mindestens 20 Ports zwischen den Basis-Ports, damit die abgeleiteten Browser-/Canvas-/CDP-Ports nie kollidieren.

Installation (Rettungs-Bot)

Portzuordnung (abgeleitet)

Basis-Port = gateway.port (oder OPENCLAW_GATEWAY_PORT / --port).
  • Browser-Control-Service-Port = Basis + 2 (nur Loopback)
  • Der Canvas-Host wird auf dem Gateway-HTTP-Server bereitgestellt (derselbe Port wie gateway.port)
  • Browserprofil-CDP-Ports werden automatisch aus browser.controlPort + 9 .. + 108 zugewiesen
Wenn Sie einen dieser Werte in der Konfiguration oder über Umgebungsvariablen überschreiben, müssen sie pro Instanz eindeutig bleiben.

Browser/CDP-Hinweise (häufige Fehlerquelle)

  • Nicht browser.cdpUrl auf dieselben Werte bei mehreren Instanzen festlegen.
  • Jede Instanz benötigt ihren eigenen Browser-Control-Port und CDP-Bereich (abgeleitet von ihrem Gateway-Port).
  • Wenn Sie explizite CDP-Ports benötigen, setzen Sie browser.profiles.<name>.cdpPort pro Instanz.
  • Remote-Chrome: Verwenden Sie browser.profiles.<name>.cdpUrl (pro Profil, pro Instanz).

Manuelles env-Beispiel

Schnelle Prüfungen