OpenClawSkills
GitHub
通道 • 即时

WebChat 指南

通过内置浏览器界面直接访问您的 AI 助手。无需设置。

OpenClaw 新手？查看我们的 ''入门教程'' 学习基础知识。本页面涵盖 WebChat 特定功能和 Gateway 控制界面。

WebChat 是 OpenClaw 的内置 Web 界面，用于与您的 AI 助手交互。它使用 Gateway WebSocket 连接，可通过 Gateway 控制界面访问，为任何具有现代 Web 浏览器的设备提供便捷的基于浏览器的聊天界面。

Tutorial.step

快速开始

访问 WebChat 很简单：

  • 启动您的 OpenClaw Gateway
  • 打开您的 Web 浏览器
  • 导航到 Gateway 控制界面
  • 开始聊天！
Tutorial.step

访问 WebChat

本地访问

在本地运行 Gateway 时，在以下位置访问 WebChat：

http://127.0.0.1:18789/

Gateway 默认在端口 18789 上运行（出于安全考虑仅限本地回环）。

远程访问

对于远程访问，您需要：

  • 设置端口转发或 SSH 隧道
  • 使用 Tailscale 或类似的 VPN 解决方案
  • 配置 Gateway 接受远程连接（需采取适当的安全措施）
  • 查看我们的远程访问指南以获取详细说明。
Tutorial.step

Gateway 控制界面

Gateway 控制界面（也称为仪表板）提供了一个用于管理 OpenClaw 的综合 Web 界面：

  • WebChat 界面 - 与您的 AI 助手聊天
  • 配置管理 - 查看和编辑配置
  • 会话监控 - 监控活动会话
  • 节点管理 - 管理连接的节点（iOS/Android 应用）
  • Gateway 状态 - 查看 Gateway 健康状况和状态
  • 通道状态 - 监控连接的通道
Tutorial.step

WebChat 功能

聊天界面

WebChat 提供现代、响应式的聊天界面：

  • 实时消息 - 通过 WebSocket 即时传递消息
  • 消息历史 - 查看对话历史
  • 流式响应 - 实时查看响应流
  • Markdown 支持 - 富文本格式
  • 代码块 - 语法高亮的代码块
  • 文件附件 - 发送和接收文件

会话管理

WebChat 默认使用主会话，但您可以：

  • 切换会话 - 访问不同的对话会话
  • 创建隔离会话 - 开始新的隔离对话
  • 查看会话历史 - 浏览过去的对话

Gateway WebSocket

WebChat 使用 Gateway WebSocket 连接进行实时通信：

  • 无需单独端口 - 使用相同的 Gateway 端口（18789）
  • WebSocket 协议 - 实时双向通信
  • 自动重连 - 优雅地处理连接中断
  • 低延迟 - 直接连接到 Gateway

WebSocket 端点

WebSocket 端点位于：

WebSocket URL
ws://127.0.0.1:18789/ws

对于 HTTPS 连接，使用 wss:// 而不是 ws://。

Tutorial.step

配置

WebChat 不需要单独的配置。当 Gateway 运行时，它自动可用。但是，您可以配置影响 WebChat 的 Gateway 设置：

Gateway 端口

如需要，更改 Gateway 端口：

Gateway 端口配置
{
  "gateway": {
    "port": 18789
  }
}

远程访问

要启用远程访问（请谨慎使用并采取适当的安全措施）：

远程访问配置
{
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0"
  }
}

安全警告

在没有适当身份验证和 HTTPS 的情况下将 Gateway 暴露到互联网存在安全风险。使用 SSH 隧道、VPN 或带有身份验证的反向代理。
Tutorial.step

浏览器兼容性

WebChat 在任何支持以下内容的现代 Web 浏览器中工作：

  • WebSocket - 用于实时通信
  • ES6+ JavaScript - 现代 JavaScript 功能
  • CSS Grid/Flexbox - 布局功能

支持的浏览器

  • Chrome/Edge (latest versions)
  • Firefox (latest versions)
  • Safari (latest versions)
  • Opera (latest versions)

Mobile Browsers

WebChat 是响应式的，可以在移动浏览器上工作，尽管原生应用（iOS/Android）提供更好的移动体验。

Tutorial.step

安全考虑

本地访问（默认）

默认情况下，Gateway 仅接受来自 localhost（127.0.0.1）的连接，这对于本地使用是安全的。

远程访问安全

如果您需要远程访问，请使用安全方法：

  • SSH 隧道 - 通过 SSH 隧道 Gateway
  • VPN - 使用 Tailscale 或类似的 VPN
  • 反向代理 - 使用带有身份验证的 nginx/traefik
  • HTTPS - 远程访问始终使用 HTTPS
  • 身份验证 - 添加身份验证层

最佳实践

  • 保持默认设置 - 除非需要，否则仅使用 localhost
  • 远程使用 VPN - 优先使用 VPN 而不是直接暴露
  • 定期更新 - 保持 OpenClaw 更新
  • 监控访问 - 定期检查 Gateway 日志
Tutorial.step

故障排除

无法访问 WebChat

如果您无法访问 WebChat：

  • 验证 Gateway 正在运行：openclaw status
  • 检查 Gateway 是否在端口 18789 上监听
  • 尝试直接访问 http://127.0.0.1:18789/
  • 检查防火墙是否阻止了端口
  • 查看 Gateway 日志以查找错误

WebSocket 连接问题

如果 WebSocket 无法连接：

  • 检查浏览器控制台是否有错误
  • 验证 Gateway 正在运行
  • 检查网络连接
  • 尝试刷新页面
  • 检查浏览器 WebSocket 支持

消息无法发送

如果消息无法发送：

  • 检查 WebSocket 连接状态
  • 验证 Gateway 正在处理消息
  • 检查浏览器控制台是否有错误
  • 尝试重新连接到 WebSocket
  • 查看 Gateway 日志