refactor: 统一项目名称从OpenFang到ZCLAW
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled

重构所有代码和文档中的项目名称,将OpenFang统一更新为ZCLAW。包括:
- 配置文件中的项目名称
- 代码注释和文档引用
- 环境变量和路径
- 类型定义和接口名称
- 测试用例和模拟数据

同时优化部分代码结构,移除未使用的模块,并更新相关依赖项。
This commit is contained in:
iven
2026-03-27 07:36:03 +08:00
parent 4b08804aa9
commit 0d4fa96b82
226 changed files with 7288 additions and 5788 deletions

View File

@@ -4,11 +4,11 @@
### 1.1 项目定位
ZCLAW 是一个**基于 OpenClaw 框架的定制化中文 AI 助手平台**,对标 AutoClaw (智谱) 和 QClaw (腾讯)。
ZCLAW 是一个**基于 ZCLAW 框架的定制化中文 AI 助手平台**,对标 AutoClaw (智谱) 和 QClaw (腾讯)。
**核心价值主张**
```
OpenClaw Gateway (成熟执行引擎)
ZCLAW Gateway (成熟执行引擎)
↕ WebSocket Protocol v3
ZCLAW Tauri App (轻量桌面 UI)
+ 中文模型 Provider (GLM/Qwen/Kimi/MiniMax)
@@ -22,15 +22,15 @@ ZCLAW Tauri App (轻量桌面 UI)
| 阶段 | 架构方向 | 状态 |
|------|----------|------|
| v1 | 自建 AI Agent 框架 (src/core/*) | 🗑️ 已归档 |
| v2 | 基于 OpenClaw + Tauri | ✅ 当前方向 |
| v2 | 基于 ZCLAW + Tauri | ✅ 当前方向 |
**架构转向原因**v1 偏离初衷约 75%,重复造轮子而非复用 OpenClaw 生态。
**架构转向原因**v1 偏离初衷约 75%,重复造轮子而非复用 ZCLAW 生态。
### 1.3 技术栈一览
| 层级 | 技术 | 版本 |
|------|------|------|
| 执行引擎 | OpenClaw Gateway | Node.js daemon |
| 执行引擎 | ZCLAW Gateway | Node.js daemon |
| 桌面壳 | Tauri | 2.0 |
| 前端框架 | React | 19.1.0 |
| 状态管理 | Zustand | 5.0.11 |
@@ -51,7 +51,7 @@ ZCLAW Tauri App (轻量桌面 UI)
| Phase 2 | 前端 Settings 页面体系 (10页) | ✅ 100% |
| Phase 3 | 聊天对接 + 分身管理 | ✅ 100% |
| Phase 3.5 | 前端质量提升 | ✅ 100% |
| Phase 4 | OpenClaw 真实集成测试 | ⏳ 待开始 |
| Phase 4 | ZCLAW 真实集成测试 | ⏳ 待开始 |
| Phase 5 | Tauri Rust sidecar + 打包发布 | 📋 规划中 |
### 2.2 代码统计
@@ -74,11 +74,11 @@ ZCLAW Tauri App (轻量桌面 UI)
## 三、核心模块深度分析
### 3.1 OpenClaw Gateway 集成层 (src/gateway/)
### 3.1 ZCLAW Gateway 集成层 (src/gateway/)
#### manager.ts - 子进程管理器
```
功能: 管理 OpenClaw Gateway 子进程生命周期
功能: 管理 ZCLAW Gateway 子进程生命周期
特性:
- 启动/停止 Gateway daemon
- 健康检查 (HTTP 探测)
@@ -88,7 +88,7 @@ ZCLAW Tauri App (轻量桌面 UI)
#### ws-client.ts - WebSocket 客户端
```
功能: 实现 OpenClaw Gateway Protocol v3
功能: 实现 ZCLAW Gateway Protocol v3
特性:
- 三步握手 (challenge → connect → hello-ok)
- 请求/响应模式 (30秒超时)
@@ -110,7 +110,7 @@ ZCLAW Tauri App (轻量桌面 UI)
#### @zclaw/feishu - 飞书 Channel Plugin
```
功能: 将飞书注册为 OpenClaw 消息渠道
功能: 将飞书注册为 ZCLAW 消息渠道
特性:
- OAuth tenant_access_token 管理 (2h 有效期, 1.5h 刷新)
- 文本/富文本消息发送
@@ -154,14 +154,14 @@ ZCLAW Tauri App (轻量桌面 UI)
| 模块 | 状态 | 替代方案 |
|------|------|----------|
| remote-execution/ | 🗑️ | OpenClaw 工具执行 |
| task-orchestration/ | 🗑️ | OpenClaw Agent Loop |
| multi-agent/ | 🗑️ | OpenClaw agents.list |
| memory/ | 🗑️ | OpenClaw Memory Plugin |
| proactive/ | 🗑️ | OpenClaw Heartbeat Engine |
| im/ | 🗑️ | OpenClaw Channel 系统 |
| db/ | 🗑️ | OpenClaw 自带 SQLite |
| config/ | 🗑️ | OpenClaw 配置系统 |
| remote-execution/ | 🗑️ | ZCLAW 工具执行 |
| task-orchestration/ | 🗑️ | ZCLAW Agent Loop |
| multi-agent/ | 🗑️ | ZCLAW agents.list |
| memory/ | 🗑️ | ZCLAW Memory Plugin |
| proactive/ | 🗑️ | ZCLAW Heartbeat Engine |
| im/ | 🗑️ | ZCLAW Channel 系统 |
| db/ | 🗑️ | ZCLAW 自带 SQLite |
| config/ | 🗑️ | ZCLAW 配置系统 |
| api/ | 🗑️ | WebSocket + Tauri Commands |
---
@@ -171,7 +171,7 @@ ZCLAW Tauri App (轻量桌面 UI)
### 4.1 架构优势 💪
1. **复用成熟生态**
- OpenClaw 28万+ Stars工具执行/Skills/MCP/心跳引擎成熟
- ZCLAW 28万+ Stars工具执行/Skills/MCP/心跳引擎成熟
- 避免重复造轮子,专注差异化价值
2. **Tauri 轻量化**
@@ -189,7 +189,7 @@ ZCLAW Tauri App (轻量桌面 UI)
### 4.2 潜在风险 ⚠️
1. **OpenClaw 依赖**
1. **ZCLAW 依赖**
- 版本兼容性风险
- 文档/社区支持限制
@@ -261,7 +261,7 @@ ZCLAW Tauri App (轻量桌面 UI)
#### 短期 (1-2周)
1. **完成 Phase 4 集成测试**
- 安装并验证 OpenClaw
- 安装并验证 ZCLAW
- 测试 Gateway 连接
- 验证插件注册
- 端到端消息收发测试
@@ -311,7 +311,7 @@ ZCLAW Tauri App (轻量桌面 UI)
| 维度 | AutoClaw (智谱) | QClaw (腾讯) | ZCLAW |
|------|----------------|--------------|-------|
| 基础框架 | OpenClaw | OpenClaw | OpenClaw |
| 基础框架 | ZCLAW | ZCLAW | ZCLAW |
| IM 渠道 | 飞书 | 微信+QQ | 飞书 (计划微信/QQ) |
| 桌面框架 | 自研 | Electron | Tauri 2.0 |
| 模型支持 | GLM 系列 | 腾讯混元 | GLM/Qwen/Kimi/MiniMax |
@@ -331,16 +331,16 @@ ZCLAW Tauri App (轻量桌面 UI)
### Phase 4: 真实集成测试 (当前优先级)
```
[ ] 1. 安装 OpenClaw
- Windows: iwr -useb https://openclaw.ai/install.ps1 | iex
- 验证: openclaw --version
[ ] 1. 安装 ZCLAW
- Windows: iwr -useb https://zclaw.ai/install.ps1 | iex
- 验证: zclaw --version
[ ] 2. 配置 Gateway
- 运行 openclaw configure
- 运行 zclaw configure
- 填入 API Key (智谱/通义/Kimi 任选)
[ ] 3. 启动 Gateway
- openclaw gateway
- zclaw gateway
- 验证: curl http://127.0.0.1:18789/health
[ ] 4. 注册 ZCLAW 插件
@@ -371,7 +371,7 @@ ZCLAW Tauri App (轻量桌面 UI)
## 七、总结
ZCLAW 是一个定位清晰的 OpenClaw 定制化项目,通过复用成熟生态 + Tauri 轻量桌面 + 中文优先策略,有望成为开源领域的 AutoClaw/QClaw 替代方案。
ZCLAW 是一个定位清晰的 ZCLAW 定制化项目,通过复用成熟生态 + Tauri 轻量桌面 + 中文优先策略,有望成为开源领域的 AutoClaw/QClaw 替代方案。
**核心建议**
1. 🎯 聚焦 Phase 4 集成测试,打通端到端流程
@@ -389,25 +389,25 @@ ZCLAW 是一个定位清晰的 OpenClaw 定制化项目,通过复用成熟生
### 8.1 Phase 4: 真实集成测试 🔌
**目标**: 打通 OpenClaw Gateway ↔ ZCLAW Tauri 端到端流程
**目标**: 打通 ZCLAW Gateway ↔ ZCLAW Tauri 端到端流程
**任务清单**:
```
[ ] 安装 OpenClaw CLI
- Windows: iwr -useb https://openclaw.ai/install.ps1 | iex
- 验证: openclaw --version
[ ] 安装 ZCLAW CLI
- Windows: iwr -useb https://zclaw.ai/install.ps1 | iex
- 验证: zclaw --version
[ ] 配置 Gateway
- 运行 openclaw configure
- 运行 zclaw configure
- 配置 API Key (智谱 GLM 作为首选)
[ ] 启动 Gateway daemon
- openclaw gateway --port 18789
- zclaw gateway --port 18789
- 验证: curl http://127.0.0.1:18789/health
[ ] 注册 ZCLAW 插件
- pnpm setup (执行 scripts/setup.ts)
- 验证插件加载: openclaw plugins list
- 验证插件加载: zclaw plugins list
[ ] 前端连接测试
- cd desktop && pnpm tauri dev
@@ -432,15 +432,15 @@ ZCLAW 是一个定位清晰的 OpenClaw 定制化项目,通过复用成熟生
**待处理目录**:
| 目录 | 文件数 | 建议操作 |
|------|--------|----------|
| src/core/remote-execution/ | ~4 | 🗑️ 删除 (OpenClaw 替代) |
| src/core/task-orchestration/ | ~3 | 🗑️ 删除 (OpenClaw 替代) |
| src/core/multi-agent/ | ~8 | 🗑️ 删除 (OpenClaw 替代) |
| src/core/memory/ | ~2 | 🗑️ 删除 (OpenClaw 替代) |
| src/core/proactive/ | ~2 | 🗑️ 删除 (OpenClaw 替代) |
| src/core/remote-execution/ | ~4 | 🗑️ 删除 (ZCLAW 替代) |
| src/core/task-orchestration/ | ~3 | 🗑️ 删除 (ZCLAW 替代) |
| src/core/multi-agent/ | ~8 | 🗑️ 删除 (ZCLAW 替代) |
| src/core/memory/ | ~2 | 🗑️ 删除 (ZCLAW 替代) |
| src/core/proactive/ | ~2 | 🗑️ 删除 (ZCLAW 替代) |
| src/core/ai/ | ~6 | ⚠️ 评估 (可能复用 Provider) |
| src/im/ | ~4 | 🗑️ 删除 (OpenClaw 替代) |
| src/db/ | ~3 | 🗑️ 删除 (OpenClaw 替代) |
| src/config/ | ~2 | 🗑️ 删除 (OpenClaw 替代) |
| src/im/ | ~4 | 🗑️ 删除 (ZCLAW 替代) |
| src/db/ | ~3 | 🗑️ 删除 (ZCLAW 替代) |
| src/config/ | ~2 | 🗑️ 删除 (ZCLAW 替代) |
| src/api/ | ~1 | 🗑️ 删除 (WebSocket 替代) |
| src/app.ts | 1 | 🗑️ 删除 |
| src/index.ts | 1 | 🔄 重写为简单入口 |