功能特性
为移动端深度优化，开箱即用的 AI 聊天体验
流式聊天
SSE 实时推送，打字机效果逐字输出，体验丝滑
语音输入
语音转文字，HTTPS 环境下一键语音对话
多媒体收发
图片/视频/音频/文件全格式支持，灯箱预览，语音气泡播放
多智能体
新建会话时可选择不同 Agent，灵活切换
快捷指令
/model、/think、/new 等指令面板，高效操作
工具调用
实时显示 AI 工具调用状态，过程透明可见
会话管理
切换、新建、删除会话，多轮对话井然有序
主题 & 国际化
亮色/暗色/跟随系统 + 中英文切换
安全认证
Token + Ed25519 设备签名，兼容 OpenClaw 2.13+
PWA + 离线缓存
IndexedDB 持久化，断网可查历史，恢复后自动同步
智能重连
断线自动恢复，无闪烁，消息去重
大屏适配
手机、平板、桌面浏览器全端响应式布局
截图预览
真实界面截图，所见即所得
登录连接
流式聊天
快捷指令
会话管理
指令面板
设置与帮助
工作原理
三层架构，代理服务端自动完成设备签名握手
为什么选 ClawApp
与 OpenClaw 原生 Web UI 的功能对比
| 功能 | OpenClaw Web UI | ClawApp |
|---|---|---|
| 手机浏览器访问 | 需要本机 | 任意设备 |
| 流式聊天 | 支持 | 支持 |
| 语音输入 | 不支持 | 支持 (HTTPS) |
| 离线消息缓存 | 不支持 | IndexedDB |
| PWA 安装 | 不支持 | 支持 |
| Android APK | 不支持 | 自动构建 |
| 外网访问 | 需自行配置 | cftunnel 一键 |
| 设备认证 | Token 明文 | Ed25519 签名 |
快速部署
一条命令，开箱即用
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawapp/main/install.sh | bash
irm https://raw.githubusercontent.com/qingchencloud/clawapp/main/install.ps1 | iex
git clone https://github.com/qingchencloud/clawapp.git cd clawapp echo 'PROXY_TOKEN=my-token-123' > .env echo 'OPENCLAW_GATEWAY_TOKEN=your-gw-token' >> .env docker compose up -d --build
git clone https://github.com/qingchencloud/clawapp.git cd clawapp && npm run install:all && npm run build:h5 cp server/.env.example server/.env # 编辑 server/.env 填入 token npm start
脚本会自动检测环境、安装依赖、构建前端、交互式配置 Token，并支持 PM2 常驻运行
外网访问
不在同一网络？一条命令搞定 HTTPS 穿透
SSH 隧道
ssh -f -N -R 0.0.0.0:3210:localhost:3210 user@server
需要公网服务器，简单快速，但无 HTTPS（语音不可用）
连接配置
打开页面后只需填写两个字段即可连接
服务器地址
局域网填 电脑IP:3210，外网填公网地址或 cftunnel 域名
App Token
你在 .env 中设置的 PROXY_TOKEN，相当于访问密码
Gateway Token
在 ~/.openclaw/openclaw.json 的 gateway.auth.token 中获取
常见问题
部署和使用中的常见疑问
一直显示「连接中」或报 502 Bad Gateway 错误？
1. 检查 OpenClaw Gateway 是否在运行：curl http://localhost:18789
2. 后台日志如果提示 Gateway 握手失败: NOT_PAIRED 或 pairing required，是因为根据 OpenClaw 的安全机制，首次连接需要作为设备进行配对审批。请在运行 Gateway 的服务端执行以下命令批准配对：
# 查看待配对设备列表并获取 requestId
openclaw gateway call device.pair.list --json
# 使用 requestId 批准配对
openclaw gateway call device.pair.approve --params '{"requestId":"<你的id>"}' --json3. 确认 OPENCLAW_GATEWAY_TOKEN 正确
4. Docker 部署时，Gateway 地址应为 ws://host.docker.internal:18789
手机打不开页面？
1. 手机和电脑是否在同一 WiFi？
2. 电脑防火墙是否放行了 3210 端口？
3. 地址是否用了电脑 IP（不是 localhost）？
语音输入按钮点了没反应？
浏览器要求 HTTPS 才能使用麦克风。局域网 HTTP 访问时，语音按钮会提示需要 HTTPS。解决方案：使用 cftunnel quick 3210 一键开启 HTTPS 隧道。
能多人同时使用吗？
可以。每个连接创建独立的 Gateway 会话，但共享同一个 OpenClaw 实例。
