WebChat（macOS 應用程式）

macOS 選單列應用程式以原生 SwiftUI 視圖的方式嵌入 WebChat UI。它連線至 Gateway，預設使用所選代理程式的 main session（透過工作階段切換器可切換至其他工作階段）。

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

啟動與除錯

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

• 測試用自動開啟：

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

• 日誌：./scripts/clawlog.sh（子系統 ai.openclaw，類別 WebChatSwiftUI）。

運作方式

• 資料平面：Gateway WS 方法 chat.history、chat.send、chat.abort、 chat.inject 以及事件 chat、agent、presence、tick、health。
• 工作階段：預設為主要工作階段（main，或 scope 為 global 時為 global）。UI 可切換工作階段。
• 引導設定使用專屬工作階段，將首次設定與一般操作分開。

安全性介面

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

已知限制

• UI 針對聊天工作階段最佳化（不是完整的瀏覽器沙箱）。