WebChat (macOS-App)

Die macOS-Menüleisten-App bettet die WebChat-UI als native SwiftUI-Ansicht ein. Sie verbindet sich mit dem Gateway und nutzt standardmäßig die Haupt-Session für den ausgewählten Agent (mit einem Session-Umschalter für andere Sessions).

  • Lokaler Modus: Verbindet sich direkt mit dem lokalen Gateway WebSocket.
  • Remote-Modus: Leitet den Gateway-Kontrollport über SSH weiter und nutzt diesen Tunnel als Datenebene.

Start & Debugging

  • Manuell: Lobster-Menü → “Open Chat”.
  • Automatisches Öffnen zum Testen: 
    dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
  • Logs: ./scripts/clawlog.sh (Subsystem bot.molt, Kategorie WebChatSwiftUI).

Wie es verdrahtet ist

  • Datenebene: Gateway-WS-Methoden chat.history, chat.send, chat.abort, chat.inject und Events chat, agent, presence, tick, health.
  • Session: Nutzt standardmäßig die primäre Session (main, oder global wenn der Scope global ist). Die UI kann zwischen Sessions wechseln.
  • Onboarding nutzt eine dedizierte Session, um das erste Setup getrennt zu halten.

Sicherheitsoberfläche

  • Der Remote-Modus leitet nur den Gateway-WebSocket-Kontrollport über SSH weiter.

Bekannte Einschränkungen

  • Die UI ist für Chat-Sessions optimiert (keine vollständige Browser-Sandbox).