b1b95e5a11
- Fix macOS Node.js/npm/openclaw detection by adding enhanced_path() with common install locations (/usr/local/bin, /opt/homebrew/bin, ~/.nvm, ~/.volta, etc.) - Add npm install error diagnosis: auto-detect git missing (exit 128), ENOENT, permission denied, network errors, cache corruption - Show macOS-specific hint when Node.js detection fails in setup page - Add shared error-diagnosis.js module used by both setup and services pages - Add troubleshooting section to README.md - Bump version to 0.4.1
OpenClaw 可视化管理面板 — 基于 Tauri v2 的跨平台桌面应用
ClawPanel 是 OpenClaw AI Agent 框架的可视化管理面板，提供服务管控、模型配置、日志查看、记忆管理等核心功能，一站式管理你的 OpenClaw 实例。
🌐 官网: claw.qt.cool | 📦 下载: GitHub Releases
下载安装
前往 Releases 页面下载最新版本，根据你的系统选择对应安装包：
macOS
| 芯片 | 安装包 | 说明 |
|---|---|---|
| Apple Silicon (M1/M2/M3/M4) | ClawPanel_x.x.x_aarch64.dmg |
2020 年末及之后的 Mac |
| Intel | ClawPanel_x.x.x_x64.dmg |
2020 年及之前的 Mac |
不确定芯片类型？点击左上角 → 关于本机，查看「芯片」一栏。
安装方式：打开 .dmg 文件，将 ClawPanel 拖入「应用程序」文件夹。
⚠️ 首次打开提示"无法验证开发者"？ 由于应用未签名，macOS 会拦截。请在终端执行以下命令解除限制：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app或者前往「系统设置 → 隐私与安全性」，找到 ClawPanel 点击「仍要打开」。
Windows
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器 | ClawPanel_x.x.x_x64-setup.exe |
推荐，双击安装 |
| MSI 安装器 | ClawPanel_x.x.x_x64_en-US.msi |
企业部署 / 静默安装 |
Linux
| 格式 | 安装包 | 说明 |
|---|---|---|
| AppImage | ClawPanel_x.x.x_amd64.AppImage |
免安装，chmod +x 后直接运行 |
| DEB | ClawPanel_x.x.x_amd64.deb |
Debian / Ubuntu：sudo dpkg -i *.deb |
| RPM | ClawPanel-x.x.x-1.x86_64.rpm |
Fedora / RHEL：sudo rpm -i *.rpm |
功能特性
- 仪表盘 — 系统概览，服务状态实时监控，快捷操作
- 服务管理 — OpenClaw 启停控制、版本检测与一键升级、Gateway 安装/卸载、配置备份与还原
- 模型配置 — 多服务商管理、模型增删改查、批量连通性测试、延迟检测、拖拽排序、自动保存+撤销
- 网关配置 — 端口、运行模式（本地/云端）、访问权限（本机/局域网）、认证 Token、Tailscale 组网
- Agent 管理 — Agent 增删改查、身份编辑、模型配置、工作区管理
- 聊天 — 流式响应、Markdown 渲染、会话管理、Agent 选择、快捷指令
- 日志查看 — 多日志源实时查看与关键词搜索
- 记忆管理 — 记忆文件查看/编辑、分类管理、ZIP 导出、Agent 切换
- 扩展工具 — cftunnel 内网穿透管理、ClawApp 状态监控
- 关于 — 版本信息、社群入口、相关项目链接、一键升级
功能截图
仪表盘 — 系统运行概览，服务状态一目了然
实时聊天 — WebSocket 流式对话，支持 Markdown 渲染与多会话管理
模型配置 — 多服务商管理，主模型+备选自动切换
记忆文件 — 在线编辑 Agent 核心配置与工作记忆
查看更多截图
Agent 管理 — 多 Agent 创建、身份配置与工作区管理
Gateway 配置 — 端口、访问权限、认证方式可视化配置
服务管理 — 启停控制、版本检测、一键升级、配置备份
日志查看 — 多日志源实时查看与关键词搜索
扩展工具 — cftunnel 内网穿透、ClawApp 移动客户端管理
系统诊断 — 全面健康检测与一键修复
技术架构
| 层级 | 技术 | 说明 |
|---|---|---|
| 前端 | Vanilla JS + Vite | 零框架依赖，轻量快速 |
| 后端 | Rust + Tauri v2 | 原生性能，跨平台打包 |
| 通信 | Tauri IPC + Shell Plugin | 前后端桥接，本地命令执行 |
| 样式 | 纯 CSS（CSS Variables） | 暗色/亮色主题，玻璃拟态风格 |
clawpanel/
├── src/ # 前端源码
│ ├── pages/ # 10 个页面模块
│ ├── components/ # 通用组件（侧边栏、弹窗、Toast）
│ ├── lib/ # 工具库（Tauri API 封装、主题）
│ ├── style/ # 样式文件
│ ├── router.js # 路由
│ └── main.js # 入口
├── src-tauri/ # Rust 后端
│ ├── src/ # Tauri 命令与业务逻辑
│ ├── Cargo.toml # Rust 依赖
│ └── tauri.conf.json # Tauri 配置
├── public/ # 静态资源
├── scripts/ # 开发与构建脚本
│ ├── dev.sh # 开发模式启动
│ └── build.sh # 编译与打包
├── .github/workflows/ # CI/CD
│ ├── ci.yml # 持续集成（push/PR 自动检查）
│ └── release.yml # 发布构建（全平台打包）
├── index.html # HTML 入口
├── vite.config.js # Vite 配置
└── package.json # 前端依赖
从源码构建
前置条件
- Node.js >= 18
- Rust (stable)
- Tauri v2 系统依赖（参考 Tauri 官方文档）
安装与开发
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm install
macOS / Linux
# 启动完整 Tauri 桌面应用
./scripts/dev.sh
# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
./scripts/dev.sh web
Windows
# 启动完整 Tauri 桌面应用
npm run tauri dev
# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
npm run dev
构建
macOS / Linux
# 编译 debug 版本
./scripts/build.sh
# 仅检查 Rust 编译（最快，不生成产物）
./scripts/build.sh check
# 编译正式发布版本（含打包）
./scripts/build.sh release
Windows
# 检查 Rust 编译
cd src-tauri && cargo check
# 编译正式发布版本
npm run tauri build
# 指定打包格式（NSIS 安装器）
npm run tauri build -- --bundles nsis
产物位于 src-tauri/target/release/ 目录。
常见问题
macOS 提示"已损坏，无法打开"
没有苹果开发者签名，macOS Gatekeeper 会拦截。终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app
或前往「系统设置 → 隐私与安全性」点击「仍要打开」。
macOS 检测不到 Node.js
从 Finder/Dock 启动 ClawPanel 时，应用的 PATH 环境变量可能不包含 Node.js 安装路径。
v0.4.1 已修复：自动补充 /usr/local/bin、/opt/homebrew/bin、~/.nvm、~/.volta 等常见路径。
临时解决：从终端启动 ClawPanel：
open /Applications/ClawPanel.app
Windows 安装 OpenClaw 报 ENOENT (-4058)
通常是文件权限或 npm 缓存问题：
- 以管理员身份运行 ClawPanel
- 或打开 PowerShell（管理员）手动安装：
npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com - 如果仍报错，清理 npm 缓存：
npm cache clean --force
Windows 安装报 exit 128 (access rights)
npm 依赖需要 Git，但系统未安装。请先安装 Git for Windows，安装后重启 ClawPanel。
安装后 Node.js 检测不到（Windows）
安装 Node.js 后需要重启 ClawPanel（或重启电脑），新的 PATH 环境变量才能生效。
相关项目
| 项目 | 说明 |
|---|---|
| OpenClaw | AI Agent 框架 |
| ClawApp | 跨平台移动聊天客户端 |
| cftunnel | Cloudflare Tunnel 内网穿透工具 |
社区交流
加入社区，交流使用心得、反馈问题、获取最新动态。
QQ 交流群 微信交流群
| 渠道 | 链接 |
|---|---|
| QQ 群 | 点击加入 |
| 微信群 | 点击加入 |
| Discord | 加入 Discord |
| 元宝派 | 加入元宝派 |
| GitHub Discussions | 参与讨论 |
| 反馈 Issue | 提交 Issue |
贡献
欢迎提交 Issue 和 Pull Request。贡献流程详见 CONTRIBUTING.md。