WebChat（macOS App）

macOS 菜单栏 App 将 WebChat UI 作为原生 SwiftUI 视图嵌入。它连接到 Gateway，默认显示所选 Agent 的主会话（也可切换到其他会话）。

• 本地模式：直接连接到本地 Gateway 的 WebSocket。
• 远程模式：通过 SSH 将 Gateway 控制端口转发，并通过该隧道作为数据通道。

启动与调试

• 手动打开：小龙虾菜单 → "Open Chat"。

• 自动打开（测试用）：

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

• 日志查看：./scripts/clawlog.sh（子系统 ai.openclaw，分类 WebChatSwiftUI）。

工作原理

• 数据通道：使用 Gateway WebSocket 方法 chat.history、chat.send、chat.abort、chat.inject，以及事件 chat、agent、presence、tick、health。
• 会话：默认连接到主会话（main，或全局范围时为 global）。UI 可在会话之间切换。
• 引导流程使用独立会话，将首次运行的初始化与正常使用隔离开来。

安全边界

• 远程模式仅通过 SSH 转发 Gateway 的 WebSocket 控制端口，不暴露其他端口。

已知限制

• 该 UI 专为聊天会话优化，并非完整的浏览器沙盒环境。