Skip to content

ClawPanel v0.21.9

Latest

Choose a tag to compare

@github-actions github-actions released this 08 Oct 03:28
· 1 commit to main since this release

✅ 全部平台构建成功

📥 下载安装

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

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 服务端安装包

🚀 首次使用

  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.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