✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包,点击文件名即可下载:
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.21.0_aarch64.dmg |
| Intel | ClawPanel_0.21.0_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"? 在终端执行:
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app,或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器(推荐) | ClawPanel_0.21.0_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.21.0_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.21.0_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.21.0_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包:Win10 1803+ 和 Win11 已预装 WebView2,推荐下载轻量版。如果是内网/断网环境,选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage(免安装) | ClawPanel_0.21.0_amd64.AppImage |
| DEB(Debian/Ubuntu) | ClawPanel_0.21.0_amd64.deb |
| RPM(Fedora/RHEL) | ClawPanel-0.21.0-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.20.1 以来的变更
新功能 (Features)
- OpenCode 第四引擎 — 新增 OpenCode 管理入口、独立工作台和受管本地运行时,支持安装、启动、停止、状态检测、在线更新与一键卸载
- 面板内置 OpenCode Web 工作台 — 左侧可直接在“运行与配置”和“工作台”之间切换,用户无需单独打开 OpenCode 页面即可管理项目、会话、模型和实际编码任务
- 统一模型渠道同步到 OpenCode — 模型渠道可同步 Provider 地址、API Key、模型列表、默认模型、上下文窗口和最大输出长度,并与 OpenClaw、Hermes、DeepSeek Harness 和助手共用同一配置入口
改进 (Improvements)
- 运行中无感更新 — 检测 npm 最新版本后,先在 staging 目录完成安装和校验,再备份并原子切换运行时;更新前正在运行的服务会自动停止并在成功后恢复
- 失败自动回滚 — OpenCode 更新安装、切换或重启失败时会恢复旧运行时,避免升级中断后留下不可用状态
- Web/headless 安全集成 — OpenCode 仅监听回环地址,ClawPanel 使用短期能力令牌代理 HTTP/WebSocket;兼容 Ubuntu Web 部署和 Tauri 桌面端
- Windows 命令兼容 — npm 安装与升级统一经
cmd.exe启动,避免 Windows Node 子进程直接调用 npm 时出现EINVAL
安全 (Security)
- 凭据与配置隔离 — OpenCode 凭据独立保存并限制文件权限,代理会剥离 ClawPanel Cookie、Authorization 和来源头,内嵌页面使用受限 sandbox
- 受管卸载边界 — 卸载会先安全停止由面板启动的 OpenCode 进程,只移除 ClawPanel 专用运行目录,并保留用户配置、凭据与工作区数据
测试与验证 (Testing)
node --test tests/*.test.js:572 项,571 passed、1 项 POSIX 用例在 Windows 跳过npm run build:通过cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo test --locked:357 passed- 本地真实生命周期:OpenCode
1.18.20 → 1.18.21运行中更新、自动重启、运行中卸载、配置保留和重新安装全部通过 - 本地 Web Playwright:桌面端及 390px 移动端管理页/工作台通过,横向溢出与浏览器控制台错误均为 0
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel