WebChat（macOS 应用）

macOS 菜单栏应用将 WebChat UI 作为原生 SwiftUI 视图嵌入。它连接到 Gateway，默认使用所选 agent 的 main 会话（另有会话切换器切换到其他会话）。

• Local 模式：直连本地 Gateway WebSocket。
• Remote 模式：通过 SSH 转发 Gateway 控制端口，以该隧道作为数据面。

启动与调试

• 手动打开：菜单 → “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，scope 为 global 时为 global）。UI 可切换会话。
• Onboarding 使用独立会话，与首次设置流程隔离。

安全面

• Remote 模式仅通过 SSH 转发 Gateway WebSocket 控制端口。

已知限制

• UI 针对聊天会话优化（不是完整的浏览器沙箱）。