✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.4_aarch64.dmg |
| Intel | ClawPanel_0.21.4_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.21.4_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.4_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.4_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.4_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.21.4_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.21.4_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.21.4-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.3 以来的变更
修复 (Fixes)
- 兼容 OpenClaw 2026.8.1 Gateway 新握手 — Web、桌面端、实时聊天和聊天诊断统一复用
connect.challenge.ts完成 Ed25519 设备签名，修复官方 8.1 运行正常但 ClawPanel 报“设备签名失败/内核过旧”的问题 - 继续兼容旧版 Gateway — 旧版 challenge 未提供时间戳时回退客户端当前时间，并保持
3..4协议协商范围；Token 与 Password 认证按 7.1/8.1 共同签名契约处理 - 纠正连接错误诊断 — 设备签名、Nonce、Public Key 错误不再误判为协议版本过旧，只有明确的协议协商错误才提示升级内核
改进 (Improvements)
- 稳定版默认使用官方原版 — 安装向导、未知来源升级、Linux 一键部署和 Docker 镜像默认使用官方
openclaw@2026.8.1；汉化版2026.7.1-2-zh.1继续作为明确选项，已有汉化安装不会被强制切换 - 增加真实 Gateway 握手回归工具 — 新增隔离设备密钥的 smoke 脚本，可分别验证官方/汉化版以及 Token/Password 认证，不读取或输出用户密钥
测试与验证 (Testing)
- 官方
openclaw@2026.8.1完成 Token 与 Password 两种真实 Gateway 握手；汉化版@qingchencloud/openclaw-zh@2026.7.1-2-zh.1完成 Token 握手，三组均协商到协议版本 4 - Node 全量测试、Rust 单元测试、生产构建、格式检查、编译检查、Clippy 严格门禁和 Linux 部署脚本语法检查通过
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel