a3ec2d0734
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
44 lines
1.5 KiB
Markdown
44 lines
1.5 KiB
Markdown
---
|
||
read_when:
|
||
- 调试 macOS WebChat 视图或 loopback 端口
|
||
summary: macOS 应用如何嵌入 Gateway 网关 WebChat 以及如何调试
|
||
title: WebChat
|
||
x-i18n:
|
||
generated_at: "2026-02-03T07:52:46Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 04ff448758e530098e2004625f33e42fc3dbe31137cd3beec2d55590e507de08
|
||
source_path: platforms/mac/webchat.md
|
||
workflow: 15
|
||
---
|
||
|
||
# WebChat（macOS 应用）
|
||
|
||
macOS 菜单栏应用将 WebChat UI 嵌入为原生 SwiftUI 视图。它连接到 Gateway 网关，默认使用所选智能体的**主会话**（带有会话切换器用于其他会话）。
|
||
|
||
- **本地模式**：直接连接到本地 Gateway 网关 WebSocket。
|
||
- **远程模式**：通过 SSH 转发 Gateway 网关控制端口，并使用该隧道作为数据平面。
|
||
|
||
## 启动和调试
|
||
|
||
- 手动：Lobster 菜单 → "Open Chat"。
|
||
- 测试时自动打开：
|
||
```bash
|
||
dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat
|
||
```
|
||
- 日志：`./scripts/clawlog.sh`（子系统 `bot.molt`，类别 `WebChatSwiftUI`）。
|
||
|
||
## 工作原理
|
||
|
||
- 数据平面：Gateway 网关 WS 方法 `chat.history`、`chat.send`、`chat.abort`、`chat.inject` 和事件 `chat`、`agent`、`presence`、`tick`、`health`。
|
||
- 会话：默认为主会话（`main`，或当范围为全局时为 `global`）。UI 可以在会话之间切换。
|
||
- 新手引导使用专用会话，以将首次运行设置分开。
|
||
|
||
## 安全面
|
||
|
||
- 远程模式仅通过 SSH 转发 Gateway 网关 WebSocket 控制端口。
|
||
|
||
## 已知限制
|
||
|
||
- UI 针对聊天会话优化（不是完整的浏览器沙箱）。
|