negodiy/openclaw
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
157d6d2db7e004ca4bfa1dfd0142d5bbd6aa8e45
openclaw/docs/zh-CN/platforms/mac/webchat.md
Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone 
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build
2026-02-02 16:38:25 +01:00

1.6 KiB
Raw Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
调试 Mac WebChat 视图或 local loopback 端口
Mac 应用如何嵌入 Gateway网关 WebChat 以及如何调试 WebChat
generated_at model provider source_hash source_path workflow
2026-02-01T21:33:23Z claude-opus-4-5 pi 04ff448758e530098e2004625f33e42fc3dbe31137cd3beec2d55590e507de08 platforms/mac/webchat.md 15

WebChat（macOS 应用）

macOS 菜单栏应用将 WebChat UI 嵌入为原生 SwiftUI 视图。它连接到 Gateway网关，默认使用所选智能体的主会话（通过会话切换器可访问其他会话）。

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

启动与调试

  • 手动：Lobster 菜单 → "Open Chat"。
  • 测试时自动打开： 
    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 针对聊天会话进行了优化（不是完整的浏览器沙箱）。