✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.22.0_aarch64.dmg |
| Intel | ClawPanel_0.22.0_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.22.0_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.22.0_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.22.0_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.22.0_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.22.0_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.22.0_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.22.0-1.x86_64.rpm |
Web / Ubuntu Server
| 类型 | 下载 | 说明 |
|---|---|---|
| 完整 Web 服务端包 | web-0.22.0.zip | 包含前端、Node 后端与版本策略；解压后执行 npm ci --omit=dev 并重启服务
|
| 桌面端前端热更新包 | frontend-hot-update-0.22.0.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.9 以来的变更
新增 (Features)
- 新增 Pi 实验引擎：受管安装、固定验证版本更新、卸载保留数据、独立运行配置页与全高聊天工作台，不依赖 OpenClaw Gateway。
- 统一模型渠道支持同步到 Pi，保留模型名称、上下文及输出上限；支持会话内切换模型、流式回复、停止生成和历史恢复。
- 接入 Pi 原生 select/confirm/input/editor 交互，写入文件与执行命令逐次审批；默认只读工具，私有配置隔离、日志脱敏。
修复 (Fixes)
- 草稿按实例与会话隔离；配置页往返和刷新恢复，发送失败不覆盖后来输入的新草稿。
- 历史会话保持自己的项目目录与工具权限，新默认配置不关闭其他会话；修复追问覆盖会话标题。
- 移除 500 条会话索引截断，恢复遗漏 JSONL 的合法历史入口；增加搜索、分批展示、后台审批提醒及指定会话进程关闭入口。
- 临时连接失败进行有界退避重试并回读状态，禁止自动重放任务；避免旁路会话列表读取失败被误报为发送失败。
- 工具守卫规范化私有目录真实路径，兼容 macOS 临时目录别名和 Windows junction，防止路径别名导致私有目录识别失效。
测试与边界 (Testing)
- 构建间接依赖 source-map-js 锁定至 1.2.2，修复 GHSA-68fv-2mgg-jv7q；未升级 Vite 或其他框架。
- 三平台 CI 和发布前门禁增加真实 Pi 1.1.0 RPC 验收，仅使用本地模拟 Provider，覆盖流式完整性、模型切换、审批、取消、项目隔离和历史恢复。
- Pi 继续标记实验版；思考档位、运行中排队/steer、附件、压缩/分支、Skills/MCP 等完整对标能力尚未开放。工作目录不是操作系统沙箱。
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel