Platforms 导读
macOS 菜单栏里的 WebChat：怎么启动、怎么接线、注意什么
这一页讲的是 macOS 菜单栏 app 如何把 WebChat 嵌成原生 SwiftUI 视图，并默认连到所选 agent 的 main session（可切换）。启动方式有两种：手动从 Lobster 菜单点“Open Chat”，或加 --webchat 参数自动打开；调试日志用 clawlog.sh。最容易搞错的是数据平面走 Gateway WS 方法（chat.history/chat.send/chat.abort），且返回的 transcript 会做显示层清理——去掉标签、工具调用 XML 和静默 token 行，超大行会被替换为占位符。
先讲这一页到底在解决什么
macOS 菜单栏里的 WebChat：怎么启动、怎么接线、注意什么
这一页讲的是 macOS 菜单栏 app 如何把 WebChat 嵌成原生 SwiftUI 视图，并默认连到所选 agent 的 main session（可切换）。启动方式有两种：手动从 Lobster 菜单点“Open Chat”，或加 --webchat 参数自动打开；调试日志用 clawlog.sh。最容易搞错的是数据平面走 Gateway WS 方法（chat.history/chat.send/chat.abort），且返回的 transcript 会做显示层清理——去掉标签、工具调用 XML 和静默 token 行，超大行会被替换为占位符。
第一站
🧵 WebChat 的数据线永远连向 Gateway，不管是本地还是远程
只是 local 模式直接连，remote 模式要先通过 SSH 隧道或别的远程通道。
Local mode
像直接插在本机 Gateway 身上。
Remote mode
像先穿过 SSH 管道，再去摸远程 Gateway 的控制端口。
默认 main session
打开聊天时会先落在主会话，就像先把你带到主桌面。
Open Chat
这是最直接的启动入口，像从 Lobster 菜单把聊天窗拉出来。