OpenClaw WebChat Kanal

WebChat kommuniziert mit dem OpenClaw Gateway über eine WebSocket-Verbindung mit drei Hauptoperationen: • chat.history — Konversationsverlauf vom Gateway abrufen • chat.send — Benutzernachrichten an den KI-Assistenten übermitteln • chat.inject — Assistenten-Notizen direkt in Transkripte einfügen und an die Oberfläche senden, ohne einen Agenten-Lauf auszulösen Im Gegensatz zu anderen Kanälen, die auf externe Dienste und Webhooks angewiesen sind, ist WebChat vollständig nativ im Gateway integriert. Nachrichten verlassen niemals Ihre Infrastruktur — die WebSocket-Verbindung besteht direkt zwischen dem UI-Client und dem Gateway-Prozess. Das Routing ist deterministisch: Antworten der KI kehren immer zur WebChat-Sitzung zurück, die die Konversation gestartet hat.

Die Authentifizierung ist für alle WebChat-Verbindungen erforderlich, auch über Loopback (localhost). Dies verhindert unbefugten Zugriff auf Ihren KI-Assistenten. OpenClaw unterstützt zwei Authentifizierungsmodi: • token — Ein gemeinsamer geheimer Token, der beim WebSocket-Handshake übergeben wird. Ideal für programmatischen Zugriff und Einzelbenutzer-Setups. • password — Passwortbasierte Authentifizierung. Geeignet für Mehrbenutzer-Umgebungen, in denen jeder Benutzer eigene Anmeldedaten hat. Mindestens ein Token oder Passwort muss konfiguriert sein, damit WebChat Verbindungen akzeptiert. Konfigurieren Sie diese in den gateway.auth-Einstellungen Ihrer openclaw.json.

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "a-strong-random-token-here"
    }
  }
}

WebChat unterstützt Remote-Konnektivität, ohne einen separaten Webserver betreiben zu müssen. Zwei Ansätze werden empfohlen: • SSH-Tunnel — Leiten Sie den Gateway-Port über SSH weiter: ssh -L 3000:localhost:3000 user@remote-host. So können Sie lokal auf WebChat zugreifen, während das Gateway auf einem entfernten Rechner läuft. • Tailscale — Verbinden Sie Ihre Geräte über das Mesh-VPN von Tailscale. Das Gateway wird über seine Tailscale-IP-Adresse erreichbar, ohne Portweiterleitung oder Firewall-Konfiguration. Für Remote-Verbindungen konfigurieren Sie die gateway.remote-Einstellungen mit der Ziel-WebSocket-URL und den Authentifizierungsdaten. Der native Client übernimmt die Wiederverbindung automatisch bei Netzwerkänderungen.

{
  "gateway": {
    "remote": {
      "url": "wss://your-remote-host:3000",
      "token": "YOUR_REMOTE_TOKEN"
    }
  }
}

WebChat verwendet Gateway-verwaltete Sitzungen, um den Konversationskontext beizubehalten. Jede WebChat-Verbindung ist mit einer Sitzung verknüpft, die den Konversationsverlauf und den KI-Kontext speichert. Sitzungen bleiben über Neuverbindungen hinweg bestehen — wenn die WebSocket-Verbindung abbricht und sich neu verbindet, wird die Konversation dort fortgesetzt, wo sie unterbrochen wurde. Die chat.history-Operation ruft bei einer Neuverbindung den vollständigen Konversationsverlauf vom Gateway ab. Die Sitzungskonfiguration wird über die session.*-Einstellungen in der openclaw.json verwaltet, einschließlich Speicher-Backend und Standard-Sitzungsschlüssel.

Wenn das Gateway nicht erreichbar ist, wechselt WebChat automatisch in den Nur-Lese-Modus. In diesem Zustand: • Der bisherige Konversationsverlauf bleibt sichtbar • Neue Nachrichten können nicht gesendet werden • Die Oberfläche zeigt den getrennten Status an • Automatische Wiederverbindungsversuche erfolgen im Hintergrund Sobald das Gateway wieder online ist, verbindet sich WebChat automatisch neu und stellt die volle Funktionalität wieder her. Es gehen keine Nachrichten aus dem Konversationsverlauf verloren, da der gesamte Verlauf vom Gateway stammt.

WebChat ist auf Apple-Plattformen als native SwiftUI-Anwendung implementiert: • macOS — Vollständiges Desktop-Erlebnis mit Tastaturkürzeln, Systembenachrichtigungen und Menüleisten-Integration • iOS — Für Mobilgeräte optimierte Oberfläche mit Push-Benachrichtigungen und Hintergrundaktualisierung Die native Implementierung bietet ein reaktionsschnelles, plattformnahes Erlebnis ohne den Overhead eines eingebetteten Browsers oder Electron-Wrappers. Textdarstellung, Scrollen und Eingabeverarbeitung nutzen durchgehend native Plattformkomponenten. Für andere Plattformen (Windows, Linux, Android) greifen Sie über den Chat-Tab der Control UI in einem beliebigen modernen Webbrowser auf WebChat zu.

WebChat verarbeitet die Nachrichtenzustellung über die WebSocket-Verbindung mit konfigurierbarem Chunking für lange KI-Antworten: • textChunkLimit — Maximale Zeichen pro Nachrichtenblock (Standard: 2000). Lange Antworten werden automatisch aufgeteilt. • blockStreaming — Wenn aktiviert, werden Antworten während der Generierung in blockbasierten Abschnitten gesendet, was Echtzeit-Feedback ermöglicht. Nachrichten werden sofort über den WebSocket zugestellt — kein Polling oder Webhook-Verzögerung. Die bidirektionale WebSocket-Verbindung ermöglicht sowohl Senden als auch Empfangen in Echtzeit.

{
  "channels": {
    "webchat": {
      "textChunkLimit": 2000,
      "blockStreaming": true
    }
  }
}

Die WebChat-Sicherheit basiert auf der Authentifizierungsschicht des Gateway. Befolgen Sie diese bewährten Praktiken für sichere Bereitstellungen: • Authentifizierung immer konfigurieren — Anonymer Zugriff ist nicht gestattet • TLS-Verschlüsselung verwenden — Verbinden Sie sich über wss:// (WebSocket Secure) für alle Remote-Verbindungen • Bind-Adresse einschränken — Verwenden Sie gateway.bind: "127.0.0.1" für rein lokalen Zugriff; vermeiden Sie die Bindung an 0.0.0.0, es sei denn, Sie verwenden einen Reverse Proxy • Starke Anmeldedaten verwenden — Generieren Sie zufällige Token oder starke Passwörter • Reverse Proxy — Für Produktionsbereitstellungen platzieren Sie das Gateway hinter einem Reverse Proxy (nginx, Caddy) mit TLS-Terminierung Wenn Sie einen Reverse Proxy auf demselben Rechner verwenden, konfigurieren Sie gateway.trustedProxies, um eine korrekte Client-IP-Erkennung sicherzustellen.