WebChat (macOS)

WebChat (macOS 應用程式)

macOS 選單列應用程式將 WebChat UI 嵌入為原生的 SwiftUI 檢視。它 連接到 Gateway，並預設為所選 Agent 的 主要工作階段 （並提供切換至其他工作階段的切換器）。

• 本機模式：直接連接到本機 Gateway WebSocket。
• 遠端模式：透過 SSH 轉發 Gateway 控制埠，並將該 通道作為資料平面。

啟動與除錯

• 手動：Lobster 選單 → 「Open Chat」。

• 用於測試的自動開啟：

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

• 日誌：./scripts/clawlog.sh (subsystem ai.openclaw, category WebChatSwiftUI)。

運作方式

• 資料平面：Gateway WS 方法 chat.history、chat.send、chat.abort、 chat.inject 以及事件 chat、agent、presence、tick、health。
• 工作階段：預設為主要工作階段 (main，或當範圍為 global 時為 global)。UI 可以在工作階段之間切換。
• Onboarding 使用專用的工作階段，以將首次執行設定分開。

安全層面

• 遠端模式僅透過 SSH 轉發 Gateway WebSocket 控制埠。

已知限制

• UI 已針對聊天工作階段進行最佳化（而非完整的瀏覽器沙箱）。