✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包,点击文件名即可下载:
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.18.5_aarch64.dmg |
| Intel | ClawPanel_0.18.5_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"? 在终端执行:
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app,或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器(推荐) | ClawPanel_0.18.5_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.18.5_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.18.5_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.18.5_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包:Win10 1803+ 和 Win11 已预装 WebView2,推荐下载轻量版。如果是内网/断网环境,选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage(免安装) | ClawPanel_0.18.5_amd64.AppImage |
| DEB(Debian/Ubuntu) | ClawPanel_0.18.5_amd64.deb |
| RPM(Fedora/RHEL) | ClawPanel-0.18.5-1.x86_64.rpm |
🚀 首次使用
- 安装并打开 ClawPanel
- 首次运行会自动检测 Node.js 环境和 OpenClaw CLI
- 如未安装 OpenClaw,按提示一键安装即可
- 安装完成后自动跳转仪表盘,开始使用
系统要求:ClawPanel Web 后端需要 Node.js 18+;运行 OpenClaw Gateway 会按当前 OpenClaw 的 engines.node 自动检测,建议 Node.js 22.19.0+。
自 v0.18.4 以来的变更
修复 (Fixes)
- Hermes 文件管理路径安全 — 文件读写/列表入口拒绝
..路径穿越,并通过 canonical path 校验新文件父目录,避免访问~/.hermes之外的路径 - 配对 token 撤销后不再复活 — 自动配对升级遇到已撤销的 operator token 时会生成新 token,不再复用带
revokedAtMs的旧 token - Linux Gateway 清理更保守 — 清理端口占用时会先确认进程命令行属于
openclaw gateway,并在/health连续无响应后才终止,避免误杀同端口其他服务或健康 Gateway - 校准不再恢复用户已删配置 — 继承模式优先使用当前非空配置,只有当前配置为空时才从
.bak回退,避免旧备份把用户主动删除的 provider/channel 恢复回来
测试与验证 (Testing)
- 已通过
node --test tests/calibration-source-policy.test.js tests/gateway-linux-cleanup-policy.test.js tests/patch-gateway-origins.test.js tests/hermes-web-config.test.js - 已通过
npm run build - 已通过
node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))" - 已通过
cd src-tauri && cargo fmt --check - 已通过
cd src-tauri && cargo check - 已通过
cd src-tauri && cargo test normalize_existing_pairing_rotates_revoked_operator_token --lib - 已通过
cd src-tauri && cargo test select_calibration_source --lib - 已通过
cd src-tauri && cargo test hermes_fs_path --lib - 已通过
cd src-tauri && cargo clippy --all-targets -- -D warnings - 已通过
git diff --check
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel