WebChat（macOS）

macOS 菜单栏应用将 WebChat 界面嵌入为原生 SwiftUI 视图。它会连接到 Gateway 网关，并默认使用所选智能体的 main 会话（也提供用于其他会话的会话切换器）。

• 本地模式：直接连接到本地 Gateway 网关 WebSocket。
• 远程模式：通过 SSH 转发 Gateway 网关控制端口，并将该隧道用作数据平面。

# 启动和调试

• 手动：Lobster 菜单 → “打开聊天”。

• 测试时自动打开：

  dist/OpenClaw.app/Contents/MacOS/OpenClaw --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>...</tool_call>、<function_call>...</function_call>、<tool_calls>...</tool_calls>、<function_calls>...</function_calls>，以及被截断的工具调用块）和泄漏的 ASCII/全角模型控制令牌会被剥离，精确匹配 NO_REPLY / no_reply 等纯静默令牌助手行会被省略，过大的行可替换为占位符。
• 会话：默认使用主会话（main，或范围为全局时使用 global）。界面可以在会话之间切换。
• 新手引导使用专用会话，以便将首次运行设置分隔开。

# 安全面

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

# 已知限制

• 该界面针对聊天会话优化（不是完整的浏览器沙箱）。

# 相关内容

• WebChat
• macOS 应用