Skip to main content

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.

macOS 菜单栏应用将 WebChat UI 作为原生 SwiftUI 视图嵌入。它连接到 Gateway,并默认针对所选代理使用主会话(其他会话可通过会话切换器切换)。
  • 本地模式:直接连接到本地 Gateway WebSocket。
  • 远程模式:通过 SSH 转发 Gateway 控制端口,并使用该隧道作为数据平面。

启动与调试

  • 手动:Lobster 菜单 → “打开聊天”。
  • 用于测试时自动打开:
    dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
    
  • 日志:./scripts/clawlog.sh(子系统 ai.openclaw,类别 WebChatSwiftUI)。

它是如何连接的

  • 数据平面:Gateway WS 方法 chat.historychat.sendchat.abortchat.inject 以及事件 chatagentpresencetickhealth
  • 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 针对聊天会话进行了优化(不是完整的浏览器沙箱)。

相关内容