7.4 WebChat

WebChat 是 Gateway 的原生聊天 UI，无需嵌入式浏览器和本地静态服务器，通过 Gateway WebSocket 连接。

概述

WebChat 提供了一个轻量级的原生聊天界面，直接与 Gateway 通信，适用于 macOS/iOS 平台。

核心特性

• 共享会话 - 使用与其他渠道相同的会话和路由规则
• 确定性路由 - 确保回复返回到 WebChat
• 历史记录 - 直接从 Gateway 获取历史记录，而非监视本地文件
• 只读模式 - 当 Gateway 不可用时自动切换为只读模式

设置要求

使用 WebChat 需要以下步骤：

1. 启动 Gateway 服务
2. 打开 WebChat UI（macOS/iOS 可用）
3. 确保 Gateway 认证配置正确

# 1. 启动 Gateway
openclaw gateway

# 2. 打开 WebChat（macOS）
openclaw webchat

远程访问

WebChat 支持通过 SSH/Tailscale 隧道进行远程操作，无需单独的服务器。

# 通过 SSH 隧道连接远程 Gateway
ssh -L 18789:127.0.0.1:18789 user@remote-host

# 然后打开 WebChat 连接到本地隧道端口

配置

WebChat 没有专门的配置块，而是通过 Gateway 的配置进行控制：

• Gateway 端点和认证选项
• gateway.port 和 gateway.bind 参数
• 会话存储设置

# Gateway 配置（影响 WebChat）
gateway:
  port: 18789
  bind: "127.0.0.1"
  auth:
    token: "your-secure-token"

# 会话存储配置
sessions:
  storage:
    type: "file"
    path: "./sessions"

与其他渠道的区别

特性	WebChat	其他渠道
界面类型	原生应用	第三方平台
历史获取	从 Gateway 获取	可能监视本地文件
离线行为	只读模式	取决于平台
服务器需求	无需额外服务器	可能需要