WebChat für macOS nutzen und debuggen

Du kennst das Problem: Du entwickelst an einem Agenten oder einem Backend und musst ständig zwischen deinem Code und einem Browser-Tab hin- und herwechseln, nur um das Interface zu testen. Das reißt dich aus dem Flow und frisst unnötig Ressourcen.

Eine native Integration direkt in der Menüleiste ist hier die bessere Wahl. Die WebChat macOS App bettet das Interface als SwiftUI View ein und verbindet sich direkt mit deinem Gateway, damit du dich voll auf die Logik konzentrieren kannst.

Voraussetzungen

• macOS (für die native SwiftUI App)
• Ein laufendes Gateway (lokal oder remote erreichbar)
• Zugriff auf das dist-Verzeichnis deines Projekts

Schnellstart

In nur zwei Schritten hast du das Interface einsatzbereit. Am schnellsten geht es über das Lobster-Menü: Wähle dort einfach “Open Chat”.

Für die Entwicklung und automatisierte Tests empfehle ich dir den Start über das Terminal. So kannst du gezielt Flags setzen:

dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat

Die App verbindet sich standardmäßig mit der main session deines ausgewählten Agents. Wenn du mit verschiedenen Sessions arbeitest, kannst du diese direkt in der UI über den Session Switcher wechseln. Für die erste Einrichtung (Onboarding) nutzt die App eine eigene, dedizierte Session, damit dein Setup sauber bleibt.

Verbindungstypen

Du hast zwei Möglichkeiten, die App mit dem Gateway zu verbinden:

• Local mode: Die App verbindet sich direkt mit dem lokalen Gateway WebSocket.
• Remote mode: Hier wird der Gateway Control Port sicher über SSH getunnelt. Dieser Tunnel dient dann als Data Plane für die Kommunikation.

Fehlerbehebung

Wenn Nachrichten nicht ankommen oder die Verbindung abbricht, solltest du die Logs prüfen. Nutze dafür das bereitgestellte Script und filtere nach dem entsprechenden Subsystem:

./scripts/clawlog.sh

Achte in der Ausgabe besonders auf das Subsystem bot.molt und die Kategorie WebChatSwiftUI. Hier siehst du sofort, ob Fehler bei den WebSocket-Methoden wie chat.send oder Events wie chat und health auftreten.

Wichtig: Die UI ist speziell für Chat-Sessions optimiert. Erwarte keine vollständige Browser-Sandbox, da der Fokus auf der direkten Interaktion mit dem Agenten liegt.

Hast du Fragen zur Konfiguration? Der AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

• Gateway API Dokumentation
• SSH Tunneling Guide
• Agent Session Management
• SwiftUI View Anpassungen