平台 • 5 分钟阅读
WebChat
mac 应用如何嵌入网关 WebChat 以及如何调试它
macOS 菜单栏应用将 WebChat UI 嵌入为原生 SwiftUI 视图。它
连接到网关并默认为所选代理的主会话
（具有用于其他会话的会话切换器）。
- 本地模式：直接连接到本地网关 WebSocket。
- 远程模式：通过 SSH 转发网关控制端口并使用该
隧道作为数据平面。
Tutorial.step
启动和调试
- 手动：Lobster 菜单 → "打开聊天"。
- 自动打开以进行测试：
''''`bash", "p4": "dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat", "p5": "''''`
dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
''''`
- 日志：''./scripts/clawlog.sh''（子系统 ''bot.molt''，类别 ''WebChatSwiftUI''）。
Tutorial.step
连接方式
- 数据平面：网关 WS 方法 ''chat.history''、''chat.send''、''chat.abort''、
''chat.inject'' 和事件 ''chat''、''agent''、''presence''、''tick''、''health''。
- 会话：默认为主会话（''main''，或当范围为 ''global'' 时
global). The UI can switch between sessions.
- 入门使用专用会话以保持首次运行设置分离。
Tutorial.step
安全表面
- 远程模式仅通过 SSH 转发网关 WebSocket 控制端口。
Tutorial.step
已知限制
- UI 针对聊天会话进行了优化（不是完整的浏览器沙盒）。