Netzwerk

Dieser Hub verlinkt die zentralen Dokumentationen dazu, wie OpenClaw Geräte über localhost, LAN und Tailnet hinweg verbindet, koppelt und absichert.

Kernmodell

Die meisten Vorgänge laufen über das Gateway (openclaw gateway), einen einzelnen dauerhaft ausgeführten Prozess, der die Kanalverbindungen und die WebSocket-Steuerungsebene verwaltet.

• Zuerst Loopback: Die Gateway-WS-Verbindung verwendet standardmäßig ws://127.0.0.1:18789. Bindungen außerhalb von Loopback verweigern den Start ohne einen gültigen Gateway-Authentifizierungspfad: Authentifizierung per gemeinsamem geheimem Token/Passwort oder eine korrekt konfigurierte trusted-proxy-Bereitstellung außerhalb von Loopback.
• Ein Gateway pro Host wird empfohlen. Führen Sie zur Isolation mehrere Gateways mit getrennten Profilen und Ports aus (Mehrere Gateways).
• Canvas-Host wird über denselben Port wie das Gateway bereitgestellt (/__openclaw__/canvas/, /__openclaw__/a2ui/) und bei einer Bindung über Loopback hinaus durch die Gateway-Authentifizierung geschützt.
• Remotezugriff erfolgt üblicherweise über einen SSH-Tunnel oder ein Tailscale-VPN (Remotezugriff).

Wichtige Referenzen:

• Gateway-Architektur
• Gateway-Protokoll
• Gateway-Betriebshandbuch
• Weboberflächen und Bindungsmodi

Kopplung und Identität

• Übersicht zur Kopplung (Direktnachrichten und Nodes)
• Vom Gateway verwaltete Node-Kopplung
• Geräte-CLI (Kopplung und Token-Rotation)
• Kopplungs-CLI (Genehmigungen für Direktnachrichten)

Lokales Vertrauen:

• Direkte lokale Loopback-Verbindungen (ohne weitergeleitete Header oder Proxy-Header) können automatisch für die Kopplung genehmigt werden, um eine reibungslose Benutzererfahrung auf demselben Host zu gewährleisten.
• OpenClaw verfügt außerdem über einen eng begrenzten, Backend- beziehungsweise Container-lokalen Selbstverbindungspfad für vertrauenswürdige Hilfsabläufe mit gemeinsamem Geheimnis.
• Tailnet- und LAN-Clients, einschließlich Tailnet-Bindungen auf demselben Host, benötigen weiterhin eine ausdrückliche Genehmigung der Kopplung.

Erkennung und Transporte

• Erkennung und Transporte
• Bonjour/mDNS
• Remotezugriff (SSH)
• Tailscale

Nodes und Transporte

• Node-Übersicht
• Bridge-Protokoll (veraltete Nodes, historisch)
• Node-Betriebshandbuch: iOS
• Node-Betriebshandbuch: Android

Sicherheit

• Sicherheitsübersicht
• Referenz zur Gateway-Konfiguration
• Fehlerbehebung
• Doctor

Verwandte Themen

• Gateway-Betriebshandbuch
• Remotezugriff