qingchencloud/clawpanel v0.18.2 on GitHub

✅ 全部平台构建成功

📥 下载安装

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

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

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

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

系统要求：ClawPanel Web 后端需要 Node.js 18+；运行 OpenClaw Gateway 会按当前 OpenClaw 的 engines.node 自动检测，建议 Node.js 22.19.0+。

Node.js 版本过低导致 Gateway 启动失败 — 启动 Gateway 前会读取当前 OpenClaw 安装包的 engines.node 要求，发现 Node.js 不兼容时提前阻断并给出可执行提示，不再让用户看到后端崩溃日志
Windows Node.js 版本过低时升级引导不足 — 设置向导在检测到 Node.js 过低时提供一键升级入口，通过 winget upgrade/install OpenJS.NodeJS.LTS 安装或升级 Node.js LTS，并在升级后刷新 PATH 检测
自定义 Node.js 路径可选中旧版本 — 扫描和手动保存 Node.js 路径时会同步校验版本兼容性，版本不满足当前 OpenClaw 要求的路径不再允许保存
macOS / Linux / Web 模式缺少同等保护 — 桌面端 macOS 启动链路、Web/headless 后端 start_service、路径扫描和自定义路径保存均补齐 Node.js 兼容检测
新手引导误导用户创建 Agent — 默认 main Agent 已内置可用；仪表盘新手步骤改为“确认默认 Agent”，有任意 Agent 即视为完成，不再要求用户创建第一个 Agent

升级弹窗体验优化 — 自动过滤 winget 进度块和旋转符号噪音；升级成功后按钮改为“完成”，并提示回到仪表盘或服务页启动 Gateway
跨端 Node.js 升级提示更清晰 — Windows 显示一键升级，macOS / Linux 显示各自的手动升级建议和重启/重新检测提示
Gateway 错误更用户友好 — 服务页会把 Node.js 版本过低错误转成普通用户能理解的升级提示
发布文案口径统一 — Release Notes、README、多语言 README 与部署文档统一说明 Node.js 要求，避免把 ClawPanel Web 后端的 Node.js 18+ 误读为当前 OpenClaw Gateway 的完整运行要求

已通过 npm run build
已通过 node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))"
已通过 cd src-tauri && cargo fmt --check
已通过 cd src-tauri && cargo check
已通过 cd src-tauri && cargo test node_requirement --lib
已通过 git diff --check
已通过 npm run tauri build（Windows NSIS / MSI 本地打包）