乐于分享
好东西不私藏

OpenClaw WebChat 功能与使用

OpenClaw WebChat 功能与使用

OpenClaw 中的 WebChat 是 OpenClaw(一个自托管的个人 AI 助手平台)内置的网页聊天界面(WebSocket-based chat UI)。

什么是 WebChat?

  • 它是一个原生聊天 UI,直接连接到 OpenClaw 的 Gateway(核心网关进程),无需嵌入浏览器或运行本地静态服务器。
  • 使用与 WhatsApp、Telegram、Slack 等其他 Channels 完全相同的会话(sessions)和路由规则。
  • 官方文档地址:https://docs.openclaw.ai/web/webchat

WebChat 主要用于:

  • 在浏览器中直接与你的 AI 代理聊天(类似 Control UI 的聊天标签页)。
  • macOS 伴侣应用中嵌入的 SwiftUI 原生视图(菜单栏 → Open Chat,或通过 --webchat 参数启动)。
  • 实时流式响应、工具调用查看、会话管理等。

如何访问和使用 WebChat?

  1. 启动 OpenClaw Gateway
     后,通常会自动提供一个 Web UI(默认类似 http://127.0.0.1:59062/ 或类似端口)。
  2. 在 Control UI(控制界面)中,左侧或主聊天区域就是 WebChat 入口。
  3. 确保已连接 AI 模型(否则聊天框可能显示但无响应,这是常见问题)。
  4. 直接输入消息即可聊天,支持流式输出、工具调用细节查看等。

macOS 用户还可以通过菜单栏快速打开,或运行命令:

text

dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat

第三方增强版 WebChat(可选)

官方 WebChat 功能已经很完整,但社区也开发了一些更美观或功能丰富的替代界面:

  • PinchChat
    :深色主题、实时流式、工具调用监控(https://marlburrow.github.io/pinchchat/)。
  • OpenCami
    :支持 PWA、智能标题、跟进建议等。

这些第三方 UI 同样通过 Gateway 的 WebSocket 连接,使用方式类似。

注意事项

  • WebChat 本质上是 OpenClaw 的一个 Channel(通道),与其他聊天 App(如 Telegram)地位相同。
  • 如果聊天不响应,通常是因为没有配置模型或会话未正确初始化。
  • 所有数据都在本地运行,隐私性高。

如果你是想问如何安装/配置、遇到具体问题(比如打不开、聊天无响应),或者需要 macOS/iOS 版的具体操作,告诉我更多细节,我可以再帮你细化!

官方文档里也有详细的 Gateway 和 WebChat 说明,推荐直接看:https://docs.openclaw.ai/web/webchat。