commit 62c510b8382d324c3c5af45c8a45f887f7ebbb7d Author: miao Date: Sun Feb 1 14:19:38 2026 +0800 Initial commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..c99eb71 --- /dev/null +++ b/README.md @@ -0,0 +1,216 @@ +# 🦞 OpenClaw Manager + +高性能跨平台 AI 助手管理工具，基于 **Tauri 2.0 + React + TypeScript + Rust** 构建。 + +![Platform](https://img.shields.io/badge/platform-macOS%20|%20Windows%20|%20Linux-blue) +![Tauri](https://img.shields.io/badge/Tauri-2.0-orange) +![React](https://img.shields.io/badge/React-18-61DAFB) +![Rust](https://img.shields.io/badge/Rust-1.70+-red) + +## ✨ 功能特性 + +### 📊 仪表盘 +- 实时服务状态监控 +- 进程内存使用统计 +- 一键启动/停止/重启 + +### 🤖 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**