✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包,点击文件名即可下载:
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 |
🚀 首次使用
- 安装并打开 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.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 passednpm run build:通过cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo 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