OpenClaw Gateway einrichten: Schnelle Konfiguration

Kennst du das Problem? Du baust eine Architektur auf und plötzlich kämpfst du mit instabilen Verbindungen und Session-Konflikten. Ein klares Netzwerkmodell spart dir hier eine Menge Kopfschmerzen und sorgt dafür, dass deine Bots stabil laufen.

Netzwerkmodell

Dieser Inhalt wurde mit Network zusammengeführt. Auf dieser Seite findest du den aktuellen Guide.

Die meisten Operationen laufen über das Gateway (openclaw gateway). Das ist ein einzelner, dauerhaft laufender Prozess, der die Channel-Verbindungen und die WebSocket-Control-Plane verwaltet.

Grundregeln

• Ich empfehle dir ein Gateway pro Host. Es ist der einzige Prozess, der die WhatsApp Web Session besitzen darf. Wenn du Rescue-Bots brauchst oder eine strikte Isolierung willst, solltest du mehrere Gateways mit isolierten Profilen und Ports nutzen. Schau dir dazu Multiple gateways an.
• Loopback zuerst: Das Gateway WS nutzt standardmäßig ws://127.0.0.1:18789. Der Wizard erstellt standardmäßig einen Gateway-Token, auch für Loopback. Für den Zugriff über ein Tailnet nutzt du diesen Befehl:

openclaw gateway --bind tailnet --token ...

Tokens sind für alle Binds außerhalb von Loopback zwingend erforderlich.

• Nodes verbinden sich je nach Bedarf über LAN, Tailnet oder SSH mit dem Gateway WS. Die alte TCP-Bridge ist veraltet und wird nicht mehr empfohlen.
• Der Canvas-Host wird vom Gateway-HTTP-Server auf demselben Port wie das Gateway bereitgestellt (Standard 18789):
  • /__openclaw__/canvas/
  • /__openclaw__/a2ui/ Wenn gateway.auth konfiguriert ist und das Gateway über Loopback hinaus bindet, sind diese Routen durch die Gateway-Auth geschützt. Node-Clients nutzen spezifische Capability-URLs, die an ihre aktive WS-Session gebunden sind. Details dazu findest du unter Gateway configuration (canvasHost, gateway).
• Für die Remote-Nutzung sind SSH-Tunnel oder Tailnet-VPN die beste Wahl. Siehe Remote access und Discovery.

Nächste Schritte

• Gateway Konfiguration
• Remote Zugriff

AI Setup Assistant