✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.2_aarch64.dmg |
| Intel | ClawPanel_0.21.2_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.21.2_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.2_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.2_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.2_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.21.2_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.21.2_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.21.2-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.1 以来的变更
修复 (Fixes)
- Gateway 缺失依赖可直接定位 — 启动诊断会识别
Cannot find package/MODULE_NOT_FOUND，明确显示缺失的 OpenClaw 运行依赖，不再让用户把 npm 安装损坏误判为模型、端口或 API Key 问题 - OpenClaw 安装完成后校验运行依赖 — Web 与桌面安装器除版本检查外，还会核对主包声明的全部直接运行依赖；镜像源返回不完整安装时自动切换 npm 官方源重装，避免“安装成功但 Gateway 无法启动”
改进 (Improvements)
- 诊断窗口支持一键修复 — 对可修复的运行依赖缺失提供“一键修复 OpenClaw”，保留现有配置、强制重装当前稳定版、完成依赖校验并自动重新启动 Gateway
- 修复流程保持安装模式 — 自动识别官方版、汉化版以及 npm/standalone 来源，优先沿用当前运行模式和 ClawPanel 绑定的稳定版本
测试与验证 (Testing)
- 使用用户实际反馈的
@openclaw/ai缺失日志补充诊断回归；Web 与 Rust 后端均覆盖不完整 npm 依赖树拒绝、完整依赖树通过和镜像失败切换官方源 node --test：589 项，588 passed、1 项 POSIX 用例在 Windows 跳过；Rustcargo test --lib：360 passed；生产构建、格式检查和 Clippy 严格门禁通过
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel