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

@@ -10,13 +10,13 @@
### 核心定位
**ZCLAW 是什么?**
- 基于 OpenClaw 的 AI 代理平台
- 不是重新造轮子,而是**扩展 OpenClaw 的能力**
- 基于 ZCLAW 的 AI 代理平台
- 不是重新造轮子,而是**扩展 ZCLAW 的能力**
- 目标:随时随地、一个 IM 入口搞定一切
### 与 OpenClaw 的关系
### 与 ZCLAW 的关系
`
OpenClaw (基础能力层)
ZCLAW (基础能力层)
ZCLAW (增强层)
@@ -24,9 +24,9 @@ ZCLAW (增强层)
`
**关键理解**
- OpenClaw 提供:浏览器控制、文件操作、终端命令、记忆系统、技能系统
- ZCLAW 提供:浏览器控制、文件操作、终端命令、记忆系统、技能系统
- ZCLAW 提供:远程执行、任务编排、多 Agent 协作、持续记忆、主动服务
- ZCLAW **复用 OpenClaw SDK**,不是重写
- ZCLAW **复用 ZCLAW SDK**,不是重写
---
@@ -39,7 +39,7 @@ ZCLAW (增强层)
`
**痛点**
- 必须坐在电脑前才能用 OpenClaw
- 必须坐在电脑前才能用 ZCLAW
- 手机只能查看,不能操控
- 无法随时随地处理任务
@@ -130,7 +130,7 @@ ZCLAW主动推送无需询问
└────────────────────┬────────────────────────────────────────┘
┌────────────────────▼────────────────────────────────────────┐
OpenClaw 基础能力层 │
ZCLAW 基础能力层 │
│ 浏览器 | 文件系统 | 终端 | AI模型 | Skills | 记忆 │
└────────────────────┬────────────────────────────────────────┘
@@ -263,7 +263,7 @@ interface TaskOrchestrationEngine {
1. AI 规划 → 生成任务图
2. 拓扑排序 → 确定执行顺序
3. 检查依赖 → 等待前置步骤
4. 执行步骤 → 调用 OpenClaw 工具
4. 执行步骤 → 调用 ZCLAW 工具
5. 更新上下文 → 传递结果
6. 推送进度 → IM 渠道
7. 错误恢复 → 重试/跳过/失败
@@ -447,11 +447,11 @@ const task: ScheduledTask = {
- 下一步行动
- 文件预览
### 与 OpenClaw 的集成
### 与 ZCLAW 的集成
` ypescript
// OpenClaw 客户端
class OpenClawClient {
// ZCLAW 客户端
class ZCLAWClient {
private rpcUrl: string;
async send(message: string): Promise<Response> {
@@ -537,7 +537,7 @@ class OpenClawClient {
|------|------|------|------|
| **语言** | TypeScript | 5.x | 类型安全 |
| **运行时** | Node.js | 22 LTS | 稳定 |
| **框架** | OpenClaw SDK | latest | 复用基础能力 |
| **框架** | ZCLAW SDK | latest | 复用基础能力 |
| **数据库** | SQLite | 9.x | 本地存储 |
| **向量** | sqlite-vec | 0.1.x | 向量搜索 |
| **队列** | BullMQ | 5.x | 任务队列 |
@@ -594,7 +594,7 @@ G:\ZClaw/
│ │ ├── src/
│ │ │ ├── main.rs # 入口
│ │ │ ├── commands.rs # Tauri 命令
│ │ │ └── openclaw.rs # OpenClaw 集成
│ │ │ └── zclaw.rs # ZCLAW 集成
│ │ ├── Cargo.toml
│ │ └── tauri.conf.json
│ ├── package.json
@@ -674,9 +674,9 @@ pnpm tauri build
- **理由**: 快速验证,降低风险
- **方案**: MVP → 增强 → 场景化
### 决策 2: 复用 OpenClaw
### 决策 2: 复用 ZCLAW
- **理由**: 不重复造轮子
- **方案**: 使用 OpenClaw SDK
- **方案**: 使用 ZCLAW SDK
### 决策 3: Tauri 桌面端
- **理由**: 跨平台、性能好
@@ -692,7 +692,7 @@ pnpm tauri build
| 风险 | 概率 | 影响 | 缓解措施 |
|------|------|------|----------|
| OpenClaw SDK 不稳定 | 中 | 高 | 多 Provider fallback |
| ZCLAW SDK 不稳定 | 中 | 高 | 多 Provider fallback |
| IM 平台封号 | 中 | 高 | 使用官方 API、合规使用 |
| 性能瓶颈 | 中 | 中 | 异步处理、缓存优化 |
| 需求变更 | 高 | 中 | 敏捷开发、MVP 优先 |
@@ -701,7 +701,7 @@ pnpm tauri build
## 📚 参考资料
- [OpenClaw 文档](C:\Program Files\AutoClaw\resources\gateway\openclaw\docs)
- [ZCLAW 文档](C:\Program Files\AutoClaw\resources\gateway\zclaw\docs)
- [Tauri 文档](https://tauri.app)
- [Koishi 文档](https://koishi.chat)
- [BullMQ 文档](https://docs.bullmq.io)