3.5 WebChat 网页聊天

WebChat 是 OpenClaw Gateway 自带的网页聊天界面，无需安装任何应用，直接通过浏览器访问。

什么是 WebChat

• Gateway 网关的原生聊天 UI
• 使用 WebSocket 实时通信
• 与其他渠道使用相同的会话和路由规则

---

快速开始

1. 启动网关

openclaw gateway

2. 访问 WebChat

在浏览器中打开：

http://localhost:8080

如果配置了认证，需要先登录。

3. 开始对话

直接在网页中发送消息即可。

---

访问方式

本地访问

http://localhost:8080

远程访问

需要通过 SSH 隧道或 Tailscale：

# SSH 隧道（本地端口转发）
ssh -L 8080:localhost:8080 user@your-server

# 或使用 Tailscale
# 直接通过 Tailscale IP 访问

⚠️ 不需要运行单独的 WebChat 服务器。

---

认证配置

WebSocket 认证与 Gateway 网关一致：

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "your-secret-token"
    }
  }
}

首次访问时需要输入 Token。

---

远程 Gateway

如果 Gateway 运行在另一台机器上：

{
  "gateway": {
    "remote": {
      "url": "https://your-gateway.example.com",
      "token": "your-token"
    }
  }
}

这样客户端会连接到远程 Gateway。

---

工作原理

• UI 连接到 Gateway WebSocket
• 使用 chat.history、chat.send、chat.inject API
• 历史记录从 Gateway 获取
• 如果 Gateway 不可达，WebChat 处于只读模式

---

与其他渠道的区别

特性	WebChat	其他渠道
需要安装	否	是（对应 App）
需要公网	否	WhatsApp 需要
媒体支持	完整	取决于渠道
推送通知	浏览器通知	渠道原生

---