OpenClaw Gateway: Ports, Remote Mode & Konfiguration

Es ist oft frustrierend, wenn man versucht, eine Anwendung lokal zu entwickeln, nur um dann an Netzwerk-Konfigurationen oder blockierten Ports zu scheitern. Wenn du dich mit der Verwaltung deines Gateways herumschlägst, bist du nicht allein – diese Hürden gehören zum Alltag, wenn man komplexe Systeme vernetzt.

Mit OpenClaw Gateway kannst du deine Remote-Verbindungen und Netzwerk-Ports effizient verwalten. Hier erfährst du, wie du dein OpenClaw Setup für den Remote-Zugriff optimierst und typische Probleme bei der Verbindung löst.

Was sind die Standard-Ports für das Gateway?

Das OpenClaw Gateway nutzt spezifische Ports für die Kommunikation zwischen dem API-Dienst und der Benutzeroberfläche. Hier ist eine Übersicht der Standardeinstellungen, die du für deine Firewall-Konfiguration benötigst:

Port	Verwendung
18789	HTTP/WS (Haupt-Port)
18790	gRPC (internes RPC)

Im Remote-Modus verwendest du den Port 18789 (oder deinen benutzerdefinierten Port) sowohl für die Control UI als auch für das Gateway WebSocket.

Warum wird angezeigt, dass das Gateway bereits läuft?

Wenn du diese Fehlermeldung erhältst, blockiert ein anderer Prozess oder ein hängengebliebener Dienst den Port. Du kannst dies schnell mit den folgenden Befehlen in deinem CLI prüfen und beheben:

# Check if the daemon is alive
openclaw gateway status

# Stop the service
openclaw gateway stop

# If you forcibly need the port
lsof -i :18789
kill -9 <pid>

Wie nutze ich das CLI im Remote-Modus?

Du kannst deine Befehle direkt an ein entferntes Gateway senden, indem du die entsprechende URL angibst. Füge dazu einfach --remote <gateway-url> zu deinen CLI-Befehlen hinzu oder setze die Umgebungsvariable OPENCLAW_GATEWAY_URL.

Beispiel:

openclaw status --remote http://my-vps-tailnet:18789

Falls dein Gateway eine Token-Authentifizierung erfordert, musst du zusätzlich OPENCLAW_GATEWAY_TOKEN setzen oder das Flag --token verwenden.

Kann ich das Gateway an eine Tailnet-Adresse binden?

Ja, das ist möglich und eine hervorragende Methode für sichere Verbindungen. Setze dazu gateway.bind: "tailnet", damit OpenClaw deine Tailscale 100.x.x.x Adresse automatisch erkennt und sich daran bindet. Vergiss dabei nicht, auch gateway.auth zu konfigurieren.

Wenn Tailscale nicht läuft oder keine IP zugewiesen wurde, startet das Gateway nicht und gibt eine Fehlermeldung aus, die besagt, dass keine Tailscale-IP gefunden wurde.

Lösung:

1. Starte Tailscale auf dem Host, damit eine 100.x-Adresse verfügbar ist.
2. Wechsle alternativ zu gateway.bind: "loopback" oder "lan".

Kann ich mehrere Gateways auf demselben Host ausführen?

In der Regel ist das nicht notwendig, da ein Gateway mehrere Messaging-Kanäle und Agents gleichzeitig verwalten kann. Nutze mehrere Gateways nur, wenn du Redundanz benötigst oder eine strikte Isolierung der Dienste erforderlich ist.

Falls du es dennoch tun musst, achte auf eine saubere Trennung:

1. Verwende unterschiedliche Ports für jedes Gateway.
2. Nutze separate Verzeichnisse für den Status (OPENCLAW_STATE_DIR).
3. Definiere eindeutige Dienstnamen in deinen Unit-Files.
4. Trenne die Pfade für Anmeldedaten, um Konflikte zu vermeiden.

Wie aktiviere ich die Remote-Administration (nicht-loopback)?

Für Bindungen, die über den lokalen Host hinausgehen, ist eine Authentifizierung zwingend erforderlich. Konfiguriere dazu gateway.bind und gateway.auth in deiner Konfigurationsdatei:

{
  gateway: {
    bind: "lan",     // or "tailnet" for Tailscale-only
    port: 18789,
    auth: {
      mode: "token",
      token: "replace-me-with-a-strong-token"
    }
  }
}

Alternativ kannst du Tailscale Serve verwenden:

openclaw gateway --tailscale serve

Warum ist das Gateway aktiv, aber die Control UI lädt nicht?

Wenn das Gateway läuft, aber die Oberfläche nicht erreichbar ist, liegt meist ein Problem mit der Erreichbarkeit vor. Überprüfe die folgenden Punkte:

1. Nutzt du http:// mit dem korrekten Hostnamen und Port?
2. Kann dein Browser die Adresse erreichen (Firewall, Tailscale oder VPN prüfen)?
3. Ist die Authentifizierung korrekt konfiguriert und hast du das Token zur Hand?

Führe openclaw gateway status auf dem Host aus, um sicherzustellen, dass der Dienst läuft. Wenn alles korrekt ist, teste den Health-Endpunkt mit diesem Befehl:

curl http://localhost:18789/health

---

Brauchst du weitere Hilfe bei der Einrichtung? Besuche unseren AI Setup Assistant.

Nächste Schritte:

• Gateway Konfiguration
• CLI Referenz