✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.1_aarch64.dmg |
| Intel | ClawPanel_0.21.1_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.21.1_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.1_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.1_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.1_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.21.1_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.21.1_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.21.1-1.x86_64.rpm |
🚀 首次使用
- 安装并打开 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.0 以来的变更
修复 (Fixes)
- 启动卡顿与重复拉起保护 — 首屏改为按需加载当前语言、合并仪表盘并发刷新，Windows 僵尸 Gateway 扫描移至后台；Web 与桌面端统一串行化 Gateway 启停操作，避免多个入口同时唤起 OpenClaw
- Gateway 启动错误可见 — 启动失败、超时和自动修复失败会保留本次新增的 stderr，并在仪表盘、服务页和设置页展示可复制的诊断信息；用户启动失败后守护进程保持停机，避免后台反复重试
改进 (Improvements)
- Hermes 稳定版升级到 0.20.5 / v2026.8.19 — 安装与更新改用官方源码安装器，并固定发布标签、提交 SHA 和安装脚本校验值，避免继续使用新版已经禁止的
uv tool install git+...构建路径 - Hermes 生命周期更可控 — Web 与桌面端统一管理源码目录、虚拟环境和安装缓存；更新继续跟随 ClawPanel 选定的稳定版，卸载只清理由面板创建的进程和运行时，默认保留用户配置、会话与数据
兼容性 (Compatibility)
- 适配 Hermes 0.20.5 CLI 与 Profile 输出 — 版本检测兼容新版
hermes --version，Profile 列表支持显示名、canonical id 和 Distribution 列 - 模型渠道与 Provider 对齐上游 — 更新内置 Provider 注册表，并补充 Gemini Native、OpenAI API、Fireworks、Tencent TokenHub、xAI OAuth 等新版接入方式
- 保护新版配置模板 — 模型同步只修改顶层模型路由，不再误改
stt.local.model等嵌套字段；Dashboard 使用外置兼容资源，避免污染受管源码目录
测试与验证 (Testing)
- Hermes 0.20.5 隔离环境完成安装、重复更新、版本检测、Profile 增删改查、Dashboard/API、模型同步、Gateway 健康检查、保留数据卸载和完整卸载闭环
- 安装结果固定到提交
fcbd1076a93841fa88855acce810e342a5b78101，源码工作区保持干净；前端、Node 测试及 Rust 质量门禁均纳入回归验证
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel