macOS 菜单栏应用将 WebChat UI 嵌入为原生 SwiftUI 视图。它连接到 Gateway 网关,默认使用所选智能体的主会话(带有会话切换器用于其他会话)。
- 本地模式:直接连接到本地 Gateway 网关 WebSocket。
- 远程模式:通过 SSH 转发 Gateway 网关控制端口,并使用该隧道作为数据平面。
启动和调试
- 手动:Lobster 菜单 → “Open Chat”。
- 测试时自动打开:
dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
- 日志:
./scripts/clawlog.sh(子系统 bot.molt,类别 WebChatSwiftUI)。
工作原理
- 数据平面:Gateway 网关 WS 方法
chat.history、chat.send、chat.abort、chat.inject 和事件 chat、agent、presence、tick、health。
- 会话:默认为主会话(
main,或当范围为全局时为 global)。UI 可以在会话之间切换。
- 新手引导使用专用会话,以将首次运行设置分开。
安全面
- 远程模式仅通过 SSH 转发 Gateway 网关 WebSocket 控制端口。
已知限制
Last modified on February 12, 2026