github qingchencloud/clawpanel v0.21.0
ClawPanel v0.21.0

4 hours ago

✅ 全部平台构建成功

📥 下载安装

根据你的操作系统选择对应安装包,点击文件名即可下载:

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

🚀 首次使用

  1. 安装并打开 ClawPanel
  2. 首次运行会自动检测 Node.js 环境和 OpenClaw CLI
  3. 如未安装 OpenClaw,按提示一键安装即可
  4. 安装完成后自动跳转仪表盘,开始使用

系统要求: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 -- --checkcargo check --lockedcargo clippy --locked --all-targets -- -D warningscargo test --locked:357 passed
  • 本地真实生命周期:OpenCode 1.18.20 → 1.18.21 运行中更新、自动重启、运行中卸载、配置保留和重新安装全部通过
  • 本地 Web Playwright:桌面端及 390px 移动端管理页/工作台通过,横向溢出与浏览器控制台错误均为 0

📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel

Don't miss a new clawpanel release

NewReleases is sending notifications on new releases.