✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.20.1_aarch64.dmg |
| Intel | ClawPanel_0.20.1_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.20.1_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.20.1_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.20.1_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.20.1_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.20.1_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.20.1_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.20.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.20.0 以来的变更
修复 (Fixes)
- Linux/Web 配置文件权限不再被锁死 — ClawPanel 以 root 运行并原子保存
openclaw.json时，会保留原文件的 UID、GID 和权限，不再把配置替换为root:root + 0600，避免 OpenClaw 原生面板和普通用户进程失去读写权限 - 桌面端与模型渠道写入保持一致 — Tauri 配置写入及模型渠道 JSON 原子替换同步保留已有 POSIX 文件元数据，新建敏感配置仍默认使用安全的
0600
兼容性 (Compatibility)
- OpenClaw 修正版基线对齐 — 推荐稳定版更新为官方
2026.7.1-2/ 汉化版2026.7.1-2-zh.1，Linux 部署、版本策略和功能目录使用同一稳定基线
安全 (Security)
- nanoid 构建依赖升级 — 锁定到
3.3.18，修复自定义生成器在长度为零时可能无限循环导致拒绝服务的问题；npm audit当前为 0 vulnerabilities
测试与验证 (Testing)
node --test tests/*.test.js：555 项，554 passed、1 项 POSIX 用例在 Windows 跳过；同一权限用例在 Linux 容器通过npm run build：通过cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo test --locked：354 passed- Linux Tauri 依赖环境：
cargo check --locked及 POSIX 元数据保留单测通过
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel