main,或当 session.scope 为 global 时使用 global),同时提供用于其他会话的会话切换器。
- 本地模式:直接连接到本地 Gateway 网关 WebSocket。
- 远程模式:通过 SSH 转发 Gateway 网关控制端口,并将该隧道用作数据平面。
启动和调试
- 手动:Lobster 菜单 -> “打开聊天”。
-
测试时自动打开:
(
--webchat可作为旧版别名使用。) -
日志:
./scripts/clawlog.sh(子系统ai.openclaw,类别WebChatSwiftUI)。
接线方式
- 数据平面:Gateway 网关 WS 方法
chat.history、chat.send、chat.abort、chat.inject,以及事件chat、agent、presence、tick、health。 chat.history返回经过显示规范化的转录内容:可见文本中的内联指令标签会被剥离,纯文本工具调用 XML 载荷(<tool_call>、<function_call>、<tool_calls>、<function_calls>,包括被截断的块)和泄露的模型控制令牌会被剥离,精确为NO_REPLY/no_reply等纯静默令牌的 assistant 行会被省略,过大的行可以替换为截断占位符。- 会话:默认使用如上所述的主会话;UI 可以在会话之间切换。
- 新手引导使用专用会话,以便将首次运行设置分离出来。
- 离线缓存:应用会按每个网关保存近期聊天会话和转录内容的小型只读缓存(
~/Library/Application Support/OpenClaw/chat-cache.sqlite):冷启动会立即绘制最后已知的转录内容,并在 Gateway 网关响应后刷新;断开连接时仍可浏览近期聊天(发送会保持禁用,直到连接恢复)。
安全面
- 远程模式仅通过 SSH 转发 Gateway 网关 WebSocket 控制端口。
已知限制
- UI 针对聊天会话优化,而不是完整的浏览器沙箱。