macOS 菜单栏应用将 WebChat UI 作为原生 SwiftUI 视图嵌入。它连接到 Gateway,并默认针对所选代理使用主会话(其他会话可通过会话切换器切换)。Documentation Index
Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
Use this file to discover all available pages before exploring further.
- 本地模式:直接连接到本地 Gateway WebSocket。
- 远程模式:通过 SSH 转发 Gateway 控制端口,并使用该隧道作为数据平面。
启动与调试
- 手动:Lobster 菜单 → “打开聊天”。
-
用于测试时自动打开:
-
日志:
./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>...</tool_call>、<function_call>...</function_call>、<tool_calls>...</tool_calls>、<function_calls>...</function_calls>,以及被截断的工具调用块)和 泄露的 ASCII/全角模型控制令牌会被移除,纯静默令牌的助手行(例如完全匹配的NO_REPLY/no_reply)会 被省略,且过大的行可能会被占位符替换。- 会话:默认使用主会话(
main,如果作用域是 global,则为global)。UI 可以在会话之间切换。 - 新手引导使用一个专用会话,以便将首次运行设置保持独立。
安全面
- 远程模式只通过 SSH 转发 Gateway WebSocket 控制端口。
已知限制
- 该 UI 针对聊天会话进行了优化(不是完整的浏览器沙箱)。