- name
- paw-chat
- description
- Install and manage Paw - a standalone web chat frontend for OpenClaw Gateway. Use when the user wants to install Paw, update Paw, or set up a web chat interface for OpenClaw. Triggers on phrases like "install paw", "setup paw chat", "web chat for openclaw", "paw frontend".
Paw Chat
🐾 Paw 是 OpenClaw 的独立 Web 聊天前端，零构建工具，零后端 —— 只需静态文件即可通过 WebSocket 连接到任何 OpenClaw Gateway。
功能特性
- 独立运行：纯静态文件，无需构建，无需后端
- WebSocket 连接：直接连接到 OpenClaw Gateway
- 多会话管理：支持切换和管理多个聊天会话
- Agent 管理：内置 Agent 配置界面（身份、性格、用户信息、定时任务）
- 图片支持：支持粘贴、拖拽、上传图片
- Markdown 渲染：完整的 Markdown 支持，包括代码高亮
- 工具调用展示：实时显示工具调用过程和结果
- 主题切换：支持深色/浅色模式
安装方式
方式一：安装到 OpenClaw Gateway（推荐）
将 Paw 安装到 Gateway 的 control-ui-static 目录，直接通过 Gateway 访问：
# 运行安装脚本
./scripts/install.sh安装后访问：https://<gateway-host>:<port>/<basePath>/chat.html
方式二：本地启动
# 进入 assets 目录
cd assets
# macOS / Linux
./start.sh
# Windows
start.bat默认端口：18790
访问：http://localhost:18790
方式三：手动部署
# 复制文件到任意 Web 服务器
cp assets/index.html /var/www/html/chat.html
cp assets/paw-app.js assets/marked.min.js assets/highlight.min.js assets/github-dark.min.css assets/logo.jpg /var/www/html/首次使用
- 打开 Paw 页面
- 点击右上角 ⚙ 设置
- 填写：
- Gateway URL: wss://<your-gateway-host>:<port> - Token: 从 ~/.openclaw/config.yaml 获取 gateway.auth.token
- 点击 连接
文件结构
assets/
├── index.html # 主页面
├── paw-app.js # 核心逻辑
├── marked.min.js # Markdown 解析器
├── highlight.min.js # 代码高亮
├── github-dark.min.css # 代码主题
├── logo.jpg # Paw Logo
├── start.sh # macOS/Linux 启动脚本
└── start.bat # Windows 启动脚本更新 Paw
重新运行安装脚本即可更新：
./scripts/install.sh卸载
删除 Gateway 目录中的文件：
rm -f ~/.openclaw/control-ui-static/chat.html
rm -f ~/.openclaw/control-ui-static/paw-app.js
rm -f ~/.openclaw/control-ui-static/marked.min.js
rm -f ~/.openclaw/control-ui-static/highlight.min.js
rm -f ~/.openclaw/control-ui-static/github-dark.min.css
rm -f ~/.openclaw/control-ui-static/logo.jpg