> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WebChat（macOS）

macOS 菜单栏应用将 WebChat UI 嵌入为原生 SwiftUI 视图。它连接到 Gateway 网关，并默认使用所选智能体的主会话（`main`，或当 `session.scope` 为 `global` 时使用 `global`），同时提供用于其他会话的会话切换器。

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

## 启动和调试

* 手动：Lobster 菜单 -> “打开聊天”。

* 测试时自动打开：

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  dist/OpenClaw.app/Contents/MacOS/OpenClaw --chat
  ```

  （`--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 针对聊天会话优化，而不是完整的浏览器沙箱。

## 相关

* [WebChat](/zh-CN/web/webchat)
* [macOS 应用](/zh-CN/platforms/macos)