<p align="center">
  <img src="public/images/logo.svg" width="120" alt="ClawPanel Logo">
</p>

<h1 align="center">ClawPanel</h1>

<p align="center">
  OpenClaw 可视化管理面板 — 基于 Tauri v2 的跨平台桌面应用
</p>

<p align="center">
  <a href="https://github.com/qingchencloud/clawpanel/blob/main/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
  </a>
  <a href="https://github.com/qingchencloud/clawpanel/releases">
    <img src="https://img.shields.io/github/v/release/qingchencloud/clawpanel" alt="Release">
  </a>
</p>

---

ClawPanel 是 [OpenClaw](https://github.com/openclaw-labs/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](https://nodejs.org/) >= 18
- [Rust](https://www.rust-lang.org/tools/install) (stable)
- Tauri v2 系统依赖（参考 [Tauri 官方文档](https://v2.tauri.app/start/prerequisites/)）

### 安装依赖

```bash
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm install
```

### 开发

```bash
# 启动完整 Tauri 桌面应用（默认）
./scripts/dev.sh

# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
./scripts/dev.sh web
```

### 构建

```bash
# 编译 debug 版本（默认）
./scripts/build.sh

# 仅检查 Rust 编译（最快，不生成产物）
./scripts/build.sh check

# 编译正式发布版本（含打包）
./scripts/build.sh release
```

## 相关项目

| 项目 | 说明 |
|------|------|
| [OpenClaw](https://github.com/openclaw-labs/openclaw) | AI Agent 框架 |
| [ClawApp](https://github.com/qingchencloud/clawapp) | 跨平台移动聊天客户端 |
| [cftunnel](https://github.com/qingchencloud/cftunnel) | Cloudflare Tunnel 内网穿透工具 |

## 贡献

欢迎提交 Issue 和 Pull Request。贡献流程详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

## 许可证

[MIT License](LICENSE)
