mirror of
https://github.com/MrFadiAi/openclaw-manager.git
synced 2026-08-14 00:57:59 +00:00
Initial commit
This commit is contained in:
miao
@@ -0,0 +1,216 @@
|
||||
# 🦞 OpenClaw Manager
|
||||
|
||||
高性能跨平台 AI 助手管理工具，基于 **Tauri 2.0 + React + TypeScript + Rust** 构建。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## ✨ 功能特性
|
||||
|
||||
### 📊 仪表盘
|
||||
- 实时服务状态监控
|
||||
- 进程内存使用统计
|
||||
- 一键启动/停止/重启
|
||||
|
||||
### 🤖 AI 模型配置
|
||||
- 支持 14+ AI 提供商
|
||||
- Anthropic Claude
|
||||
- OpenAI GPT
|
||||
- DeepSeek
|
||||
- Kimi (Moonshot)
|
||||
- Google Gemini
|
||||
- OpenRouter
|
||||
- Groq
|
||||
- Mistral
|
||||
- Ollama（本地）
|
||||
- 更多...
|
||||
- 自定义 API 地址
|
||||
- 模型快速切换
|
||||
|
||||
### 📱 消息渠道
|
||||
- Telegram Bot
|
||||
- Discord Bot
|
||||
- Slack
|
||||
- 飞书
|
||||
- 微信
|
||||
- iMessage
|
||||
|
||||
### ⚡ 服务管理
|
||||
- 后台服务控制
|
||||
- 实时日志查看
|
||||
- 开机自启配置
|
||||
|
||||
### 🧪 测试诊断
|
||||
- 系统环境检查
|
||||
- AI 连接测试
|
||||
- 渠道连通性测试
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 环境要求
|
||||
|
||||
- **Node.js** >= 18.0
|
||||
- **Rust** >= 1.70
|
||||
- **pnpm** (推荐) 或 npm
|
||||
|
||||
### macOS 额外依赖
|
||||
|
||||
```bash
|
||||
xcode-select --install
|
||||
```
|
||||
|
||||
### Windows 额外依赖
|
||||
|
||||
- [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
|
||||
- [WebView2](https://developer.microsoft.com/en-us/microsoft-edge/webview2/)
|
||||
|
||||
### Linux 额外依赖
|
||||
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt update
|
||||
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
|
||||
|
||||
# Fedora
|
||||
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libxdo-devel
|
||||
```
|
||||
|
||||
### 安装与运行
|
||||
|
||||
```bash
|
||||
# 克隆项目
|
||||
git clone https://github.com/miaoxworld/OpenClawInstaller.git
|
||||
cd OpenClawInstaller/openclaw-manager
|
||||
|
||||
# 安装依赖
|
||||
npm install
|
||||
|
||||
# 开发模式运行
|
||||
npm run tauri:dev
|
||||
|
||||
# 构建发布版本
|
||||
npm run tauri:build
|
||||
```
|
||||
|
||||
## 📁 项目结构
|
||||
|
||||
```
|
||||
openclaw-manager/
|
||||
├── src-tauri/ # Rust 后端
|
||||
│ ├── src/
|
||||
│ │ ├── main.rs # 入口
|
||||
│ │ ├── commands/ # Tauri Commands
|
||||
│ │ │ ├── service.rs # 服务管理
|
||||
│ │ │ ├── config.rs # 配置管理
|
||||
│ │ │ ├── process.rs # 进程管理
|
||||
│ │ │ └── diagnostics.rs # 诊断功能
|
||||
│ │ ├── models/ # 数据模型
|
||||
│ │ └── utils/ # 工具函数
|
||||
│ ├── Cargo.toml
|
||||
│ └── tauri.conf.json
|
||||
│
|
||||
├── src/ # React 前端
|
||||
│ ├── App.tsx
|
||||
│ ├── components/
|
||||
│ │ ├── Layout/ # 布局组件
|
||||
│ │ ├── Dashboard/ # 仪表盘
|
||||
│ │ ├── AIConfig/ # AI 配置
|
||||
│ │ ├── Channels/ # 渠道配置
|
||||
│ │ ├── Service/ # 服务管理
|
||||
│ │ ├── Testing/ # 测试诊断
|
||||
│ │ └── Settings/ # 设置
|
||||
│ └── styles/
|
||||
│ └── globals.css
|
||||
│
|
||||
├── package.json
|
||||
├── vite.config.ts
|
||||
└── tailwind.config.js
|
||||
```
|
||||
|
||||
## 🛠️ 技术栈
|
||||
|
||||
| 层级 | 技术 | 说明 |
|
||||
|------|------|------|
|
||||
| 前端框架 | React 18 | 用户界面 |
|
||||
| 状态管理 | Zustand | 轻量级状态管理 |
|
||||
| 样式 | TailwindCSS | 原子化 CSS |
|
||||
| 动画 | Framer Motion | 流畅动画 |
|
||||
| 图标 | Lucide React | 精美图标 |
|
||||
| 后端 | Rust | 高性能系统调用 |
|
||||
| 跨平台 | Tauri 2.0 | 原生应用封装 |
|
||||
|
||||
## 📦 构建产物
|
||||
|
||||
运行 `npm run tauri:build` 后，会在 `src-tauri/target/release/bundle/` 生成：
|
||||
|
||||
| 平台 | 格式 |
|
||||
|------|------|
|
||||
| macOS | `.dmg`, `.app` |
|
||||
| Windows | `.msi`, `.exe` |
|
||||
| Linux | `.deb`, `.AppImage` |
|
||||
|
||||
## 🎨 设计理念
|
||||
|
||||
- **暗色主题**：护眼舒适，适合长时间使用
|
||||
- **现代 UI**：毛玻璃效果、流畅动画
|
||||
- **响应式**：适配不同屏幕尺寸
|
||||
- **高性能**：Rust 后端，极低内存占用
|
||||
|
||||
## 🔧 开发命令
|
||||
|
||||
```bash
|
||||
# 开发模式（热重载）
|
||||
npm run tauri:dev
|
||||
|
||||
# 仅运行前端
|
||||
npm run dev
|
||||
|
||||
# 构建前端
|
||||
npm run build
|
||||
|
||||
# 构建完整应用
|
||||
npm run tauri:build
|
||||
|
||||
# 检查 Rust 代码
|
||||
cd src-tauri && cargo check
|
||||
|
||||
# 运行 Rust 测试
|
||||
cd src-tauri && cargo test
|
||||
```
|
||||
|
||||
## 📝 配置说明
|
||||
|
||||
### Tauri 配置 (tauri.conf.json)
|
||||
|
||||
- `app.windows` - 窗口配置
|
||||
- `bundle` - 打包配置
|
||||
- `plugins.shell.scope` - Shell 命令白名单
|
||||
- `plugins.fs.scope` - 文件访问白名单
|
||||
|
||||
### 环境变量
|
||||
|
||||
应用会读取 `~/.openclaw/env` 中的环境变量配置。
|
||||
|
||||
## 🤝 贡献指南
|
||||
|
||||
1. Fork 项目
|
||||
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
|
||||
3. 提交更改 (`git commit -m 'Add amazing feature'`)
|
||||
4. 推送到分支 (`git push origin feature/amazing-feature`)
|
||||
5. 创建 Pull Request
|
||||
|
||||
## 📄 许可证
|
||||
|
||||
MIT License - 详见 [LICENSE](LICENSE)
|
||||
|
||||
## 🔗 相关链接
|
||||
|
||||
- [OpenClaw 主项目](https://github.com/miaoxworld/OpenClawInstaller)
|
||||
- [Tauri 官方文档](https://tauri.app/)
|
||||
- [React 官方文档](https://react.dev/)
|
||||
|
||||
---
|
||||
|
||||
**Made with ❤️ by OpenClaw Team**
|
||||
Reference in New Issue
Block a user