mirror of
https://github.com/qingchencloud/clawpanel.git
synced 2026-05-06 20:02:49 +08:00
84a6ab4d45a60669b644dcdb16282a6402c73ec9
- 替换所有不可用的 `alert`, `confirm`, `prompt` 调用为异步的自定义 `Modal` 组件以适配 Tauri WebView 的 API 限制。 - 优化与重构核心服务组件接口,增加模型有效性测试 (`test_model`) 以及依赖更新支持。 - 同步补齐 `README.md` 与 `CHANGELOG.md` 新增的系统特性说明(含仪表盘、日记、存储、重构页面调整)。
ClawPanel
OpenClaw 可视化管理面板 — 基于 Tauri v2 的跨平台桌面应用
ClawPanel 是 OpenClaw AI Agent 框架的可视化管理面板,提供服务管控、模型配置、日志查看、记忆管理等核心功能,一站式管理 OpenClaw 实例。
功能截图
截图待补充
功能特性
- 仪表盘 — 系统概览,服务状态实时监控
- 服务管理 — OpenClaw 服务状态监控与启停控制、版本检测、配置自动备份、备份状态查看与快速还原
- 模型配置 — 多服务商管理、模型增删改查、支持快速验证网络连通性 (Model Test)、一键应用默认配置
- 网关配置 — Gateway 端口配置、运行模式管理与认证相关设置项,支持自动重载
- 日志查看 — 多日志源(OpenClaw 核心与 Gateway)实时查看与关键字搜索
- 记忆管理 — OpenClaw 记忆文件系统的动态管理及内容预览,支持打包下载 (.zip) 或部分导出
- 扩展工具 — Cloudflare Tunnel 内网穿透隧道管理 (cftunnel)、ClawApp 相关连接与状态检测
- 关于 — 版本信息、核心组件与开源项目指引、社群与联系入口
技术架构
| 层级 | 技术 | 说明 |
|---|---|---|
| 前端 | Vanilla JS + Vite | 零框架依赖,轻量快速 |
| 后端 | Rust + Tauri v2 | 原生性能,跨平台打包 |
| 通信 | Tauri IPC + Shell Plugin | 前后端桥接,本地命令执行 |
| 样式 | 纯 CSS(CSS Variables) | 暗色主题,玻璃拟态风格 |
clawpanel/
├── src/ # 前端源码
│ ├── pages/ # 8 个页面模块
│ ├── 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 # 编译与打包
├── 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
开发
# 启动完整 Tauri 桌面应用(默认)
./scripts/dev.sh
# 仅启动 Vite 前端(浏览器调试,使用 mock 数据)
./scripts/dev.sh web
构建
# 编译 debug 版本(默认)
./scripts/build.sh
# 仅检查 Rust 编译(最快,不生成产物)
./scripts/build.sh check
# 编译正式发布版本(含打包)
./scripts/build.sh release
相关项目
| 项目 | 说明 |
|---|---|
| OpenClaw | AI Agent 框架 |
| ClawApp | 跨平台移动聊天客户端 |
| cftunnel | Cloudflare Tunnel 内网穿透工具 |
贡献
欢迎提交 Issue 和 Pull Request。贡献流程详见 CONTRIBUTING.md。
许可证
Description
Languages
JavaScript
63.1%
Rust
24.4%
CSS
10.5%
Shell
1.1%
HTML
0.6%
Other
0.2%