✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.5_aarch64.dmg |
| Intel | ClawPanel_0.21.5_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.21.5_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.5_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.5_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.5_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.21.5_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.21.5_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.21.5-1.x86_64.rpm |
Web / Ubuntu Server
| 类型 | 下载 | 说明 |
|---|---|---|
| 完整 Web 服务端包 | web-0.21.5.zip | 包含前端、Node 后端与版本策略；解压后执行 npm ci --omit=dev 并重启服务
|
| 桌面端前端热更新包 | frontend-hot-update-0.21.5.zip | 仅供 ClawPanel 桌面端热更新，不可作为 Web 服务端安装包 |
🚀 首次使用
- 安装并打开 ClawPanel
- 首次运行会自动检测 Node.js 环境和 OpenClaw CLI
- 如未安装 OpenClaw，按提示一键安装即可
- 安装完成后自动跳转仪表盘，开始使用
系统要求：ClawPanel Web 后端需要 Node.js 18+；运行 OpenClaw Gateway 会按当前 OpenClaw 的 engines.node 自动检测，OpenClaw 2026.7.1 要求 Node.js 22.22.3+（22.x）。
自 v0.21.4 以来的变更
修复 (Fixes)
- 修复 OpenClaw 2026.8.1 WebSocket 远程 Origin 拒绝 — Web/Ubuntu 代理不再把浏览器公网或局域网 Origin 直接传给本机 Gateway，统一使用受面板 Session 保护的 loopback 上游来源，实时聊天、路由地图、渠道运行态与梦境模式恢复连接
- 阻止 Web 前后端混装 —
/__api/health返回后端版本和 API 契约版本；浏览器检测到只替换dist/导致版本不一致时停止加载，并明确提示安装完整 Web 包
改进 (Improvements)
- 区分完整 Web 包与桌面热更新包 — Release 中
web-x.y.z.zip改为可独立运行的完整 Node Web 服务端包，frontend-hot-update-x.y.z.zip仅保留给桌面端前端热更新，避免用户误装
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel