Mehrere Gateways auf demselben Host betreiben

Du kennst das sicher: Ein Prozess hängt sich auf oder eine Fehlkonfiguration blockiert den Zugriff, und plötzlich reagiert dein gesamtes Setup nicht mehr. Wenn alles über ein einziges Gateway läuft, kann ein kleiner Fehler das System lahmlegen. Besonders wenn du Änderungen an der Konfiguration testen oder einen Notfall-Zugang (Rescue Bot) behalten willst, ist eine saubere Trennung der Instanzen auf demselben Rechner wichtig.

Normalerweise reicht ein Gateway aus, da es mehrere Verbindungen und Agents verarbeiten kann. Für eine stärkere Isolation oder Redundanz kannst du jedoch separate Gateways mit isolierten Profilen und Ports starten.

Voraussetzungen

Bevor du mehrere Instanzen startest, musst du sicherstellen, dass die folgenden Ressourcen pro Instanz isoliert sind:

OPENCLAW_CONFIG_PATH — Eigene Konfigurationsdatei pro Instanz
OPENCLAW_STATE_DIR — Eigene Sessions, Credentials und Caches
agents.defaults.workspace — Separates Workspace-Verzeichnis
gateway.port (oder --port) — Eindeutiger Port pro Instanz
Abgeleitete Ports (Browser/Canvas) dürfen sich nicht überschneiden

Schnellstart

Der empfohlene Weg zur Trennung sind Profile mit dem --profile Flag. Diese scopen automatisch OPENCLAW_STATE_DIR sowie OPENCLAW_CONFIG_PATH und hängen Suffixe an die Service-Namen an.

1. Main Gateway einrichten

# Main Profile initialisieren
openclaw --profile main setup

# Gateway auf Standard-Port starten
openclaw --profile main gateway --port 18789

2. Rescue Gateway einrichten

# Rescue Profile initialisieren
openclaw --profile rescue setup

# Gateway auf einem anderen Port starten
openclaw --profile rescue gateway --port 19001

3. Services installieren

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

4. Status überprüfen

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

Rescue-Bot Guide

Ein Rescue-Bot läuft als zweites Gateway auf demselben Host. Er bleibt isoliert, damit er Debugging-Aufgaben übernehmen oder Konfigurationsänderungen anwenden kann, selbst wenn der primäre Bot down ist.

Achte beim Port-Mapping darauf, mindestens 20 Ports Abstand zwischen den Base Ports zu lassen. So verhinderst du, dass die automatisch abgeleiteten Ports für Browser, Canvas oder CDP kollidieren.

Installation des Rescue-Bots

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

# Rescue Bot (isoliertes Profil + Ports)
openclaw --profile rescue onboard
# Hinweis:
# - Workspace-Name erhält standardmäßig das Suffix -rescue
# - Port sollte mindestens 18789 + 20 Ports sein (z. B. 19789)
# - Der Rest des Onboarding-Prozesses entspricht dem Standard

Port Mapping (abgeleitet)

Der Base Port wird über gateway.port, OPENCLAW_GATEWAY_PORT oder --port definiert. Davon leiten sich weitere Ports ab:

Browser Control Service Port = Base Port + 2 (nur Loopback)
canvasHost.port = Base Port + 4
Browser Profile CDP Ports werden automatisch im Bereich browser.controlPort + 9 bis + 108 vergeben.

Wenn du diese Werte in der Config oder via Umgebungsvariablen überschreibst, musst du sie pro Instanz eindeutig halten.

Fehlerbehebung

Browser/CDP Konflikte

Ein häufiger Fehler ist das manuelle Festlegen von CDP-Werten, die sich dann überschneiden.

Pinne browser.cdpUrl niemals auf die gleichen Werte in mehreren Instanzen.
Jede Instanz benötigt ihren eigenen Browser Control Port und CDP-Bereich.
Falls du explizite CDP-Ports benötigst, nutze browser.profiles.<name>.cdpPort pro Instanz.
Bei Remote Chrome verwendest du browser.profiles.<name>.cdpUrl (pro Profil und Instanz).

Manueller Env-Beispiel

Falls du keine Profile nutzen möchtest, kannst du die Pfade manuell setzen:

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

OPENCLAW_CONFIG_PATH=~/.openclaw/rescue.json \
OPENCLAW_STATE_DIR=~/.openclaw-rescue \
openclaw gateway --port 19001

Hast du Fragen zur Konfiguration? Nutze den AI Setup Assistant.

Nächste Schritte

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.