OpenClaw WebChat einrichten: Native macOS/iOS UI verbinden

Kennst du das? Du willst nur kurz mit deinem Agenten chatten, aber musst erst mühsam einen lokalen Server aufsetzen oder dich durch ein träges Web-Interface quälen. WebChat löst das, indem es direkt auf den Gateway WebSocket zugreift und dir eine native Erfahrung bietet.

WebChat (Gateway WebSocket UI)

Status: Die macOS/iOS SwiftUI Chat-UI kommuniziert direkt mit dem Gateway WebSocket.

Was es ist

• Eine native Chat-UI für das Gateway (kein eingebetteter Browser und kein lokaler statischer Server).
• Verwendet dieselben Sessions und Routing-Regeln wie andere Channels.
• Deterministisches Routing: Antworten gehen immer zurück an WebChat.

Schnellstart

1. Starte das Gateway.
2. Öffne die WebChat UI (macOS/iOS App) oder den Chat-Tab der Control UI.
3. Stelle sicher, dass die Gateway Auth konfiguriert ist (standardmäßig erforderlich, auch auf Loopback).

Funktionsweise (Verhalten)

• Die UI verbindet sich mit dem Gateway WebSocket und nutzt chat.history, chat.send sowie chat.inject.
• chat.history ist für die Stabilität begrenzt: Das Gateway kann lange Textfelder kürzen, schwere Metadaten weglassen und zu große Einträge durch [chat.history omitted: message too large] ersetzen.
• chat.inject fügt eine Assistant-Notiz direkt an das Transkript an und sendet sie an die UI (kein Agent-Run).
• Abgebrochene Runs können teilweise Assistant-Ausgaben in der UI sichtbar lassen.
• Das Gateway speichert abgebrochene, teilweise Assistant-Texte in der Transkript-Historie, wenn gepufferter Output existiert, und markiert diese Einträge mit Abort-Metadaten.
• Die History wird immer vom Gateway abgerufen (kein lokales File-Watching).
• Wenn das Gateway nicht erreichbar ist, befindet sich WebChat im Read-only-Modus.

Control UI Agents Tools Panel

• Das Control UI /agents Tools Panel hat zwei separate Ansichten:
  • Available Right Now nutzt tools.effective(sessionKey=...) und zeigt, was die aktuelle Session zur Laufzeit tatsächlich nutzen kann, einschließlich Core-, Plugin- und Channel-eigenen Tools.
  • Tool Configuration nutzt tools.catalog und konzentriert sich auf Profile, Overrides und die Katalog-Semantik.
• Die Verfügbarkeit zur Laufzeit ist Session-bezogen. Das Wechseln der Session beim selben Agenten kann die Liste Available Right Now verändern.
• Der Config-Editor impliziert keine Verfügbarkeit zur Laufzeit; der effektive Zugriff folgt weiterhin der Policy-Rangfolge (allow/deny, Per-Agent und Provider/Channel Overrides).

Remote-Nutzung

• Der Remote-Modus tunnelt den Gateway WebSocket über SSH oder Tailscale.
• Du musst keinen separaten WebChat-Server betreiben.

Konfigurations-Referenz (WebChat)

Vollständige Konfiguration: Configuration

WebChat-Optionen:

• gateway.webchat.chatHistoryMaxChars: Maximale Zeichenanzahl für Textfelder in chat.history Antworten. Wenn ein Transkript-Eintrag dieses Limit überschreitet, kürzt das Gateway lange Textfelder und ersetzt zu große Nachrichten eventuell durch einen Platzhalter. Ein pro-Request maxChars kann auch vom Client gesendet werden, um diesen Standardwert für einen einzelnen chat.history Aufruf zu überschreiben.

Zugehörige globale Optionen:

• gateway.port, gateway.bind: WebSocket Host/Port.
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket Auth (Token/Passwort).
• gateway.auth.mode: "trusted-proxy": Reverse-Proxy Auth für Browser-Clients (siehe Trusted Proxy Auth).
• gateway.remote.url, gateway.remote.token, gateway.remote.password: Remote Gateway Ziel.
• session.*: Session-Speicher und Standardwerte für Hauptschlüssel.

Nächste Schritte

• Gateway Konfiguration
• Trusted Proxy Auth verstehen

AI Setup Assistant