✅ 全部平台构建成功
📥 下载安装
根据你的操作系统选择对应安装包，点击文件名即可下载：
macOS
| 芯片 | 安装包 |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_0.18.3_aarch64.dmg |
| Intel | ClawPanel_0.18.3_x64.dmg |
⚠️ 首次打开提示"无法验证开发者"？ 在终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app，或前往 系统设置 → 隐私与安全性 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器（推荐） | ClawPanel_0.18.3_x64-setup.exe | 轻量版 ~10 MB |
| EXE 完整包 | ClawPanel_0.18.3_x64-setup-full.exe | 含 WebView2 ~200 MB |
| MSI 安装器 | ClawPanel_0.18.3_x64_en-US.msi | 轻量版 ~10 MB |
| MSI 完整包 | ClawPanel_0.18.3_x64-full_en-US.msi | 含 WebView2 ~200 MB |
💡 轻量版 vs 完整包：Win10 1803+ 和 Win11 已预装 WebView2，推荐下载轻量版。如果是内网/断网环境，选择完整包。
Linux
| 格式 | 安装包 |
|---|---|
| AppImage（免安装） | ClawPanel_0.18.3_amd64.AppImage |
| DEB（Debian/Ubuntu） | ClawPanel_0.18.3_amd64.deb |
| RPM（Fedora/RHEL） | ClawPanel-0.18.3-1.x86_64.rpm |
🚀 首次使用
- 安装并打开 ClawPanel
- 首次运行会自动检测 Node.js 环境和 OpenClaw CLI
- 如未安装 OpenClaw，按提示一键安装即可
- 安装完成后自动跳转仪表盘，开始使用
系统要求：ClawPanel Web 后端需要 Node.js 18+；运行 OpenClaw Gateway 会按当前 OpenClaw 的 engines.node 自动检测，建议 Node.js 22.19.0+。
自 v0.18.2 以来的变更
修复 (Fixes)
- 最新版 OpenClaw 的 Node.js 门槛兼容 — 继续保留当前稳定推荐版不变；当用户已安装 OpenClaw
2026.6.5或更高版本时，面板会按新版运行要求检测 Node.js>=22.19.0，旧稳定版不会被误拦截 - standalone OpenClaw Node.js 检测误判 — standalone 安装会优先使用同目录捆绑的
node/node.exe做兼容检测，避免被 PATH 中较旧的系统 Node.js 误判 - 配对修复覆盖配置风险 — Gateway 配对流程只增量写入
gateway.controlUi.allowedOrigins，避免用旧的全量配置快照覆盖用户刚保存的模型、认证或安全配置 - 配置写回保留深层字段 —
openclaw.json写回改为对象递归合并，数组与标量仍显式替换，减少升级或自动修复时丢失未知配置字段的风险
兼容性 (Compatibility)
- 兼容 Parallel Web Search 插件 — Web 搜索后端白名单补充
parallel-free与parallel，并保留plugins.entries.parallel.config.webSearch.apiKey/baseUrl等插件配置 - 保留 OpenClaw 新增配置项 — 支持并保留
memory.qmd.rerank与security.installPolicy；校准/重置配置时会继承memory、security等高级配置块 - Linux 部署默认仍走稳定版 — 一键部署脚本默认安装
@qingchencloud/openclaw-zh@2026.5.18-zh.1，仅当检测到 OpenClaw2026.6.5+时才提升 Node.js 运行门槛
改进 (Improvements)
- Hermes 配置页补充 QMD 与 Install Policy — 记忆配置新增 QMD rerank 开关，安全配置新增 Install Policy JSON 编辑入口，并保留其他高级 YAML 字段
- 第三方服务商接入规范更清晰 — 贡献指南新增 provider 接入规范，要求服务商 PR 保持中性技术接入，不夹带默认推广位或未经确认的商业宣传
测试与验证 (Testing)
- 已通过
git diff --check - 已通过
bash -n scripts/linux-deploy.sh - 已通过
npm run build - 已通过
node --test tests/patch-gateway-origins.test.js tests/node-runtime-detection-policy.test.js tests/hermes-web-config.test.js tests/hermes-memory-config.test.js tests/hermes-security-config.test.js tests/hermes-config-page-ui.test.js - 已通过
cd src-tauri && cargo fmt --check - 已通过
cd src-tauri && cargo check - 已通过
cd src-tauri && cargo test --lib - 已通过
cd src-tauri && cargo clippy --all-targets -- -D warnings
📖 项目主页 · 💬 反馈问题 · 📣 QQ 群 · Telegram: https://t.me/clawpanel