✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.3_aarch64.dmg |
| Intel | ClawPanel_0.21.3_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.21.3_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.3_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.3_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.3_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.21.3_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.21.3_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.21.3-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.2 以来的变更
兼容性 (Compatibility)
- 适配 OpenClaw 2026.8.1 Agent 注册表 — Web 与桌面端同时支持旧版
agents.list[]和新版agents.entries.{id}，Agent 列表、增删改、身份、模型、Workspace、Memory 与 Skills 均按当前内核配置形状读写，并为多 Agent 配置维护ownership: "explicit" - 清理 8.1 退役配置字段 — 校准、普通保存、Docker 节点同步和已有配置回读会按已安装内核版本移除
commands.ownerDisplay*与gateway.controlUi.allowInsecureAuth；旧汉化内核继续保留原字段，避免两套严格 schema 互相污染 - 适配 8.1 模型策略语义 — 保留
agents.defaults.models作为模型元数据；仅在用户已经启用显式modelPolicy.allow时同步白名单，避免把新版默认的 allow-any 配置意外收紧 - Web 端补齐 OpenClaw Doctor — Web/Ubuntu 可直接执行当前绑定 CLI 的诊断与修复；8.1 自动使用非交互迁移参数，Web 改为异步子进程并将迁移超时提升至 120 秒，桌面端同步提升超时
- 官方稳定版基线更新 — 官方 OpenClaw 推荐版本更新为
2026.8.1；汉化版继续保持当前已发布的2026.7.1-2-zh.1，避免向旧内核写入新版配置形状
测试与验证 (Testing)
- 官方 npm
openclaw@2026.8.1隔离运行时完成旧agents.list→ 新agents.entriesDoctor 迁移、配置回读、Gateway 启动、HTTP 200、CLI health 与 RPC status 验证；ClawPanel 直接生成的 8.1 keyed 配置通过官方 schema 校验 - 当前本机汉化版
2026.7.1-zh.2隔离配置继续通过旧agents.listschema 校验 node --test tests/*.test.js：597 项，596 passed、1 项 POSIX 用例在 Windows 跳过；Rustcargo test --locked：363 passed；生产构建、格式检查、编译检查和 Clippy 严格门禁通过
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel