升级提示
- Windows 桌面端请下载安装新的 EXE 或 MSI（轻量包或含 WebView2 的完整包均可）。本次包含 Rust 后端修复，只更新前端不能应用后台终端弹窗修复。
- Web 部署请使用完整
web-0.22.5.zip更新并重启 Node 服务，不要只复制dist。 - Telegram 二维码为本地图片；扫码、点击二维码和加入按钮均使用同一群邀请。桌面点击交给既有系统浏览器能力，Web 点击开新标签。
- 本版不改变内核推荐版本，不合入尚未完成验收的 Hermes 升级候选。
✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.22.5_aarch64.dmg |
| Intel | ClawPanel_0.22.5_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.22.5_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.22.5_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.22.5_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.22.5_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.22.5_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.22.5_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.22.5-1.x86_64.rpm |
Web / Ubuntu Server
| 类型 | 下载 | 说明 |
|---|---|---|
| 完整 Web 服务端包 | web-0.22.5.zip | 包含前端、Node 后端与版本策略；解压后执行 npm ci --omit=dev 并重启服务
|
| 桌面端前端热更新包 | frontend-hot-update-0.22.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.22.4 以来的变更
修复 (Fixed)
- 修复 Windows 后台命令反复弹出终端的问题：统一隐藏内核状态探测、命令路径查询及安装、启停等辅助进程窗口，保留标准输出、错误日志和原有超时。
- Windows Gateway 普通启动不再创建可见终端，启动失败继续通过面板诊断与日志展示；不影响用户显式打开外部应用。
- 关于页的社群交流新增 Telegram 群按钮和本地二维码，使用同一官方邀请链接；点击二维码或按钮在浏览器打开，保留现有社区入口。
验证范围 (Testing)
- 补充后台命令隐藏策略、实际自有子进程控制台可见性及 Telegram 页面回归；后台隐藏不等于完成各内核全部功能的原生界面验收。
- 本次为界面和后台进程热修复，不合入未完成验收的 Hermes 升级候选，不改变内核推荐版本或日常自动发布门禁。
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel