clawpanel/README.md at e62f27042290002684cf303e4313f4a1ee301993

mirror of https://github.com/qingchencloud/clawpanel.git synced 2026-05-06 20:02:49 +08:00

Files

晴天 e62f270422 chore: 跨平台构建脚本 + CI/CD 改进 + 行尾规范

- 新增 .gitattributes 统一 LF 行尾，解决 Mac/Windows 协作 CRLF 问题
- 新增 build.ps1 Windows 本地构建脚本（支持 -Debug/-Clean 参数）
- 新增 build.sh macOS/Linux 本地构建脚本
- 新增 .windsurf/workflows/release.md 发版操作工作流
- release.yml: 将 Release Notes 更新抽为独立 job，彻底解决多 matrix job 竞争条件
- release.yml: 补充代码签名环境变量注释占位，开源后可直接配 Secrets 启用
- ci.yml: 增加 cargo fmt --check 和 cargo clippy -D warnings 质量门禁
- .gitignore: 补充 Windows 平台特有文件、内部报告、IDE 文件
- docs/index.html: 修正 openclaw 仓库 URL
- README.md: 修正 openclaw 仓库 URL

2026-03-04 12:17:48 +08:00

6.6 KiB

Raw Blame History

OpenClaw 可视化管理面板 — 基于 Tauri v2 的跨平台桌面应用

ClawPanel 是 OpenClaw AI Agent 框架的可视化管理面板，提供服务管控、模型配置、日志查看、记忆管理等核心功能，一站式管理你的 OpenClaw 实例。

下载安装

前往 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 拖入「应用程序」文件夹。首次打开如遇安全提示，前往「系统设置 → 隐私与安全性」点击「仍要打开」。

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 状态监控
关于 — 版本信息、社群入口、相关项目链接、一键升级

功能截图

截图待补充 — 欢迎提交 PR 补充各页面截图

技术架构

层级	技术	说明
前端	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/ 目录。

项目	说明
OpenClaw	AI Agent 框架
ClawApp	跨平台移动聊天客户端
cftunnel	Cloudflare Tunnel 内网穿透工具

贡献

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

许可证

MIT License

6.6 KiB Raw Blame History Unescape Escape

下载安装

macOS

Windows

Linux

功能特性

功能截图

技术架构

从源码构建

前置条件

安装与开发

macOS / Linux

Windows

构建

macOS / Linux

Windows

相关项目

贡献

许可证

6.6 KiB

Raw Blame History