OpenClaw 白皮书
WebChat(Gateway 网关 WebSocket UI)
状态:macOS/iOS SwiftUI 聊天 UI 直接与 Gateway 网关 WebSocket 通信。
它是什么
- ✦Gateway 网关的原生聊天 UI(无嵌入式浏览器,无本地静态服务器)。
- ✦使用与其他渠道相同的会话和路由规则。
- ✦确定性路由:回复始终返回到 WebChat。
快速开始
- ✦启动 Gateway 网关。
- ✦打开 WebChat UI(macOS/iOS 应用)或控制 UI 聊天标签页。
- ✦确保已配置 Gateway 网关认证(默认需要,即使在 loopback 上)。
工作原理(行为)
- ✦UI 连接到 Gateway 网关 WebSocket 并使用
chat.history、chat.send和chat.inject。 - ✦
chat.inject直接将助手注释追加到转录并广播到 UI(无智能体运行)。 - ✦历史记录始终从 Gateway 网关获取(无本地文件监听)。
- ✦如果 Gateway 网关不可达,WebChat 为只读模式。
远程使用
- ✦远程模式通过 SSH/Tailscale 隧道传输 Gateway 网关 WebSocket。
- ✦你不需要运行单独的 WebChat 服务器。
配置参考(WebChat)
完整配置:配置
渠道选项:
- ✦没有专用的
webchat.*块。WebChat 使用下面的 Gateway 网关端点 + 认证设置。
相关的全局选项:
- ✦
gateway.port、gateway.bind:WebSocket 主机/端口。 - ✦
gateway.auth.mode、gateway.auth.token、gateway.auth.password:WebSocket 认证。 - ✦
gateway.remote.url、gateway.remote.token、gateway.remote.password:远程 Gateway 网关目标。 - ✦
session.*:会话存储和主键默认值。