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
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:
@@ -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 | 🔄 重写为简单入口 |
|
||||
|
||||
Reference in New Issue
Block a user