WebChat (macOS-App)

Die macOS-Menüleisten-App bettet die WebChat-UI als native SwiftUI-View ein. Sie verbindet sich mit dem Gateway und verwendet standardmäßig die Main-Session für den ausgewählten Agenten (mit einem Session-Switcher für andere Sessions).

  • Lokaler Modus: verbindet sich direkt mit dem lokalen Gateway-WebSocket.
  • Remote-Modus: leitet den Gateway-Control-Port über SSH weiter und nutzt diesen Tunnel als Datenebene.

Start & Debugging

  • Manuell: Lobster-Menü → „Chat öffnen”.

  • Auto-Open zum Testen:

    dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
  • Logs: ./scripts/clawlog.sh (Subsystem ai.openclaw, 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: 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 First-Run-Setup getrennt zu halten.

Sicherheitsoberfläche

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

Bekannte Einschränkungen

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