Skip to content

ClawPanel v0.19.2

Latest

Choose a tag to compare

@github-actions github-actions released this 05 Aug 05:13

✅ 全部平台构建成功

📥 下载安装

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

macOS

芯片 安装包
Apple Silicon (M1/M2/M3/M4) ClawPanel_0.19.2_aarch64.dmg
Intel ClawPanel_0.19.2_x64.dmg

⚠️ 首次打开提示"无法验证开发者"? 在终端执行:sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app,或前往 系统设置 → 隐私与安全性 点击「仍要打开」。

Windows

格式 安装包 说明
EXE 安装器(推荐) ClawPanel_0.19.2_x64-setup.exe 轻量版 ~10 MB
EXE 完整包 ClawPanel_0.19.2_x64-setup-full.exe 含 WebView2 ~200 MB
MSI 安装器 ClawPanel_0.19.2_x64_en-US.msi 轻量版 ~10 MB
MSI 完整包 ClawPanel_0.19.2_x64-full_en-US.msi 含 WebView2 ~200 MB

💡 轻量版 vs 完整包:Win10 1803+ 和 Win11 已预装 WebView2,推荐下载轻量版。如果是内网/断网环境,选择完整包。

Linux

格式 安装包
AppImage(免安装) ClawPanel_0.19.2_amd64.AppImage
DEB(Debian/Ubuntu) ClawPanel_0.19.2_amd64.deb
RPM(Fedora/RHEL) ClawPanel-0.19.2-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.19.1 以来的变更

兼容性 (Compatibility)

  • OpenClaw 新版 Web 配置同步恢复 — Web/headless 保存模型 Provider 后,会同步更新 openclaw.json 与每个 Agent 的 models.json,连接信息、模型能力、上下文长度和结构化密钥保持一致;运行中的 Gateway 会在回读确认后重启加载新配置
  • Hermes Agent 新版 Profile 适配 — 同时兼容新版纯名称列表和旧版状态表格,Profile 页面可直接配置 Provider/模型,聊天页可在 Gateway 停止时直接启动

改进 (Improvements)

  • LM Studio 上下文长度可编辑 — 模型编辑器新增 contextTokens 字段,不再固定为 50000;保存后同步到主配置和所有 Agent,并在刷新后正确回显
  • Linux Web 自定义端口 — 原生部署支持 CLAWPANEL_PORT / PANEL_PORT,Docker 与 Compose 的监听端口和健康检查会跟随 PORT 配置
  • Hermes Profile 移动端布局 — Profile 操作区支持自动换行,按钮满足移动端触控高度并消除横向溢出

修复 (Fixes)

  • Web Gateway 探测返回 HTTP 500 — 移除 ESM 运行时残留的 require('net'),端口关闭时稳定返回 false,不再污染控制台或阻断模型保存流程
  • Docker 镜像构建和运行失败 — 复用官方 Node 镜像内置用户,避免 Alpine UID/GID 1000 冲突;补齐 Web API、运行时模块和 public 静态资源,生产镜像可完整构建并加载页面资源
  • Hermes Profile 信息缺失 — 修复新版 profile list 输出被旧表格解析器过滤的问题,并保持桌面端与 Web 端解析行为一致

安全 (Security)

  • PostCSS 构建依赖升级 — 锁定到 8.5.25,修复受控 sourceMappingURL 在缺少 from 时可能读取任意 .map 文件的问题;npm audit 当前为 0 vulnerabilities
  • Rust 网络与序列化依赖升级quinn-proto 更新到 0.11.15,修复乱序流重组可能造成的远程内存耗尽;serde_with 更新到 3.21.0,修复空序列或 Map 条目序列化 panic

测试与验证 (Testing)

  • node --test tests/*.test.js:537 passed
  • npm run build:通过
  • cargo fmt --all -- --checkcargo check --lockedcargo clippy --locked --all-targets -- -D warningscargo test --locked:通过
  • 本地生产 Web Playwright:OpenClaw 核心路由、LM Studio 配置同步、Hermes Gateway/Profile 和移动端布局全部通过,页面错误、HTTP 500、失败请求和控制台错误均为 0
  • Linux Docker 实测:镜像构建、OpenClaw CLI、LM Studio 50000 → 196608 写入/Agent 同步/刷新回读、自定义端口及健康检查全部通过

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