127 lines
4.1 KiB
Markdown
127 lines
4.1 KiB
Markdown
# ZCLAW 🦞 — OpenClaw 定制版 (Tauri Desktop)
|
||
|
||
像 AutoClaw (智谱) 和 QClaw (腾讯) 一样，对 [OpenClaw](https://github.com/openclaw/openclaw) 进行定制化封装，打造中文优先的 Tauri 桌面 AI 助手。
|
||
|
||
## 核心定位
|
||
|
||
```
|
||
OpenClaw Gateway (执行引擎)
|
||
↕ WebSocket
|
||
ZCLAW Tauri App (桌面 UI)
|
||
+ 中文模型 Provider (GLM/Qwen/Kimi/MiniMax)
|
||
+ 飞书 Channel Plugin
|
||
+ 分身(Clone) 管理
|
||
+ 自定义 Skills
|
||
```
|
||
|
||
## 功能特色
|
||
|
||
- **基于 OpenClaw**: 真实工具执行 (bash/file/browser)、Skills 生态、MCP 协议、心跳引擎
|
||
- **中文模型**: 智谱 GLM-5、通义千问、Kimi K2.5、MiniMax (OpenAI 兼容 API)
|
||
- **飞书集成**: 飞书 Channel Plugin，在飞书中直接对话指挥电脑
|
||
- **分身系统**: 多个独立 Agent 实例，各有自己的角色、记忆、配置
|
||
- **Tauri 桌面**: Rust + React 19，体积小 (~10MB)，性能好
|
||
- **设置页面**: 对标 AutoClaw — 通用/模型/MCP/技能/IM/工作区/隐私
|
||
|
||
## 技术栈
|
||
|
||
| 层级 | 技术 |
|
||
|------|------|
|
||
| **执行引擎** | OpenClaw Gateway (Node.js, ws://127.0.0.1:18789) |
|
||
| **桌面壳** | Tauri 2.0 (Rust + React 19) |
|
||
| **前端** | React 19 + TailwindCSS + Zustand + Lucide Icons |
|
||
| **自定义插件** | TypeScript (OpenClaw Plugin API) |
|
||
| **通信协议** | OpenClaw Gateway WebSocket Protocol v3 |
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ZClaw/
|
||
├── desktop/ # Tauri 桌面应用 (React 前端)
|
||
│ ├── src/
|
||
│ │ ├── components/ # UI 组件
|
||
│ │ ├── store/ # Zustand 状态管理
|
||
│ │ └── lib/gateway-client.ts # Gateway WebSocket 客户端
|
||
│ └── src-tauri/ # Rust 后端 (TODO)
|
||
│
|
||
├── src/gateway/ # Gateway 管理层
|
||
│ ├── manager.ts # OpenClaw 子进程管理
|
||
│ ├── ws-client.ts # Node.js WebSocket 客户端
|
||
│ └── index.ts
|
||
│
|
||
├── plugins/ # ZCLAW 自定义 OpenClaw 插件
|
||
│ ├── zclaw-chinese-models/ # 中文模型 Provider (GLM/Qwen/Kimi/MiniMax)
|
||
│ ├── zclaw-feishu/ # 飞书 Channel Plugin
|
||
│ └── zclaw-ui/ # UI 扩展 RPC 方法
|
||
│
|
||
├── skills/ # 自定义 Skills
|
||
│ ├── chinese-writing/ # 中文写作
|
||
│ └── feishu-docs/ # 飞书文档操作
|
||
│
|
||
├── config/ # OpenClaw 默认配置
|
||
│ ├── openclaw.default.json # Gateway 配置模板
|
||
│ ├── SOUL.md # Agent 人格
|
||
│ ├── AGENTS.md # Agent 指令
|
||
│ ├── IDENTITY.md # Agent 身份
|
||
│ └── USER.md # 用户偏好
|
||
│
|
||
├── scripts/setup.ts # 首次设置脚本
|
||
├── docs/ # 文档
|
||
│ ├── architecture-v2.md # 架构设计
|
||
│ ├── deviation-analysis.md # 偏离分析报告
|
||
│ └── autoclaw界面/ # AutoClaw 参考截图
|
||
└── src/core/ # [归档] v1 旧代码
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 1. 安装 OpenClaw
|
||
|
||
```bash
|
||
# Windows
|
||
iwr -useb https://openclaw.ai/install.ps1 | iex
|
||
|
||
# macOS / Linux
|
||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||
```
|
||
|
||
### 2. 安装 ZCLAW
|
||
|
||
```bash
|
||
git clone https://github.com/xxx/ZClaw.git
|
||
cd ZClaw
|
||
pnpm install
|
||
pnpm setup # 注册插件 + 复制配置
|
||
```
|
||
|
||
### 3. 配置 API Key
|
||
|
||
```bash
|
||
openclaw configure # 交互式配置
|
||
# 或手动编辑 ~/.openclaw/openclaw.json
|
||
```
|
||
|
||
### 4. 启动
|
||
|
||
```bash
|
||
openclaw gateway # 启动 OpenClaw Gateway
|
||
cd desktop && pnpm tauri dev # 启动 Tauri 桌面应用
|
||
```
|
||
|
||
## 对标参考
|
||
|
||
| 产品 | 基于 | IM 渠道 | 桌面框架 |
|
||
|------|------|---------|----------|
|
||
| **QClaw** (腾讯) | OpenClaw | 微信 + QQ | Electron |
|
||
| **AutoClaw** (智谱) | OpenClaw | 飞书 | 自研 |
|
||
| **ZCLAW** (本项目) | OpenClaw | 飞书 (+ 微信/QQ 计划中) | Tauri 2.0 |
|
||
|
||
## 文档
|
||
|
||
- [架构设计](docs/architecture-v2.md) — 完整的 v2 架构方案
|
||
- [偏离分析](docs/deviation-analysis.md) — 与 QClaw/AutoClaw/OpenClaw 对标分析
|
||
|
||
## License
|
||
|
||
MIT
|