Mehrere Gateways (gleicher Host)

Die meisten Setups sollten einen Gateway nutzen, da ein einzelner Gateway mehrere Messaging-Verbindungen und Agenten bedienen kann. Bei Bedarf an stärkerer Isolation oder Redundanz (z. B. Rettungs-Bot) separate Gateways mit isolierten Profilen/Ports betreiben.

Isolations-Checkliste (erforderlich)

CLAWDBOT_CONFIG_PATH — Konfigurationsdatei pro Instanz
CLAWDBOT_STATE_DIR — Sitzungen, Credentials, Caches pro Instanz
agents.defaults.workspace — Workspace-Root pro Instanz
gateway.port (oder --port) — eindeutig pro Instanz
Abgeleitete Ports (Browser/Canvas) dürfen sich nicht überschneiden

Werden diese geteilt, kommt es zu Konfigurations-Konflikten und Port-Kollisionen.

Empfohlen: Profile (`--profile`)

Profile begrenzen automatisch CLAWDBOT_STATE_DIR + CLAWDBOT_CONFIG_PATH und hängen Dienstnamen an.


# main
openclaw --profile main setup
openclaw --profile main gateway --port 18789

# rescue
openclaw --profile rescue setup
openclaw --profile rescue gateway --port 19001

Dienste pro Profil:


openclaw --profile main gateway install
openclaw --profile rescue gateway install

Rettungs-Bot-Anleitung

Einen zweiten Gateway auf demselben Host mit eigenem Profil/Konfiguration, State-Verzeichnis, Workspace und Basis-Port (plus abgeleitete Ports) betreiben. So bleibt der Rettungs-Bot vom Haupt-Bot isoliert und kann debuggen oder Konfigurationsänderungen anwenden, wenn der primäre Bot ausfällt. Port-Abstand: mindestens 20 Ports zwischen Basis-Ports lassen, damit die abgeleiteten Browser-/Canvas-/CDP-Ports nicht kollidieren.

Installation (Rettungs-Bot)


# Haupt-Bot (bestehend oder neu, ohne --profile)
# Läuft auf Port 18789 + Chrome CDC/Canvas/... Ports
openclaw onboard
openclaw gateway install

# Rettungs-Bot (isoliertes Profil + Ports)
openclaw --profile rescue onboard
# Hinweise:
# - Workspace-Name wird standardmäßig mit -rescue versehen
# - Port sollte mindestens 18789 + 20 Ports sein,
#   besser völlig anderen Basis-Port wählen, z. B. 19789,
# - Rest des Onboardings wie gewohnt

# Dienst installieren (falls nicht automatisch beim Onboarding)
openclaw --profile rescue gateway install

Port-Mapping (abgeleitet)

Basis-Port = gateway.port (oder CLAWDBOT_GATEWAY_PORT / --port).

Browser-Control-Service-Port = Basis + 2 (nur Loopback)
canvasHost.port = Basis + 4
Browser-Profil-CDP-Ports werden automatisch aus browser.controlPort + 9 .. + 108 vergeben

Wenn Sie einen davon in Konfiguration oder Umgebung überschreiben, müssen sie pro Instanz eindeutig bleiben.

Browser-/CDP-Hinweise (typische Fallstricke)

Nicht browser.cdpUrl auf dieselben Werte für mehrere Instanzen festlegen.
Jede Instanz braucht ihren eigenen Browser-Control-Port und CDP-Bereich (abgeleitet vom Gateway-Port).
Bei expliziten CDP-Ports browser.profiles.<name>.cdpPort pro Instanz setzen.
Remote-Chrome: browser.profiles.<name>.cdpUrl nutzen (pro Profil, pro Instanz).

Manuelles Umgebungs-Beispiel


CLAWDBOT_CONFIG_PATH=~/.clawdbot/main.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-main \
openclaw gateway --port 18789

CLAWDBOT_CONFIG_PATH=~/.clawdbot/rescue.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-rescue \
openclaw gateway --port 19001

Schnellprüfungen


openclaw --profile main status
openclaw --profile rescue status
openclaw --profile rescue browser status