WebChat (macOS 应用)

macOS 菜单栏应用将 WebChat UI 作为原生 SwiftUI 视图嵌入。它连接到网关,并默认为所选代理的主会话(带有会话切换器以切换其他会话)。

• 本地模式:直接连接到本地网关 WebSocket。
• 远程模式:通过 SSH 转发网关控制端口,并使用该隧道作为数据平面。

启动与调试

• 手动:Lobster 菜单 → "打开聊天"。
• 测试时自动打开:

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

• 日志:./scripts/clawlog.sh(子系统 bot.molt,类别 WebChatSwiftUI)。

工作原理

• 数据平面:网关 WS 方法 chat.history、chat.send、chat.abort、 chat.inject 和事件 chat、agent、presence、tick、health。
• 会话:默认为主会话(main,或当作用域为全局时为 global)。UI 可以在会话之间切换。
• 引导使用专用会话,以将首次运行设置保持独立。

安全范围

• 远程模式仅通过 SSH 转发网关 WebSocket 控制端口。

已知限制

• UI 针对聊天会话进行了优化(不是完整的浏览器沙箱)。