跳转到主要内容

WebChat(macOS 应用)

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.historychat.sendchat.abortchat.inject 和事件 chatagentpresencetickhealth
  • 会话:默认为主会话(main,或当范围为全局时为 global)。UI 可以在会话之间切换。
  • 新手引导使用专用会话,以将首次运行设置分开。

安全面

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

已知限制

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