✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.9_aarch64.dmg |
| Intel | ClawPanel_0.21.9_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.21.9_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.9_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.9_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.9_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.21.9_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.21.9_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.21.9-1.x86_64.rpm |
Web / Ubuntu Server
| 类型 | 下载 | 说明 |
|---|---|---|
| 完整 Web 服务端包 | web-0.21.9.zip | 包含前端、Node 后端与版本策略；解压后执行 npm ci --omit=dev 并重启服务
|
| 桌面端前端热更新包 | frontend-hot-update-0.21.9.zip | 仅供 ClawPanel 桌面端热更新，不可作为 Web 服务端安装包 |
🚀 首次使用
- 安装并打开 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.8 以来的变更
兼容性 (Compatibility)
- 官方 OpenClaw 稳定基线更新至 2026.9.8；默认安装、部署脚本与 Docker 镜像同步，保留旧版协议及汉化版选择，不自动升级现有运行时。
- Hermes 稳定安装目标更新至 0.21.5（v2026.9.24），固定源码提交和安装器校验；适配新版受管 Python/Node 与安装阶段顺序。
- DeepSeek Harness 更新目标为 npm 推荐的 0.2.0-rc.2，仍标记为预发布版；不默认切换到 OpenClaw beta 或 DSH alpha。
修复 (Fixes)
- 修复 Hermes 能力接口认证与 Web handler 方法绑定，恢复启动和聊天链路。
- Hermes 原生 YAML 端口、环境变量端口按正确优先级探测；旧面板端口别名迁移为原生字段，保留原字段及备份。启动守护保留 host、port、嵌套选项和其他平台配置。
- 多 Gateway 看板识别新共享宿主及命名 Profile 的宿主记录，使用实际监听端口，避免重复启动和按进程名批量结束其他实例。
- 修复 DSH 新版登录的相对根目录跳转识别，继续限制认证 Cookie 和跳转目标；验证内嵌工作台模型切换及刷新保留选择。
- 修复 Docker 构建输入遗漏引擎后端模块、共享库和版本策略，排除本机测试运行时与依赖缓存。生产 Node 升至 OpenClaw 要求的 24.16.0。
测试与验证 (Testing)
- 增加端口环境回退、旧端口迁移、共享宿主发现、认证、Web 方法绑定及 Docker 打包回归。
- 实际 OpenClaw Gateway 握手和配置读回、Hermes Profile/共享宿主/模型对话/服务启停、DSH 内嵌模型切换及流式对话通过隔离验证；聊天使用本地测试模型。
- 新增独立的手动 Runtime Compatibility 工作流，验证实际 Docker 镜像的 Web 健康、配置校验与 Gateway 握手。现有三平台 CI 门禁保持不变。
- 版本与验证范围见
docs/compatibility-2026-10-07.md；真实渠道账户、真实付费模型和预发布 beta/alpha 不纳入本次端到端验收。
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel