iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

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

Browse Source 
重构所有代码和文档中的项目名称，将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
Download Patch File Download Diff File Expand all files Collapse all files

94
docs/archive/openclaw-to-openfang-migration-brainstorm.md
View File

@@ -1,13 +1,13 @@
# ZClaw: 从 OpenClaw 切换到 OpenFang 头脑风暴分析
# ZClaw: 从 ZCLAW 切换到 ZCLAW 头脑风暴分析
> **分析日期**：2026-03-13
> **目标**：评估 ZClaw 从 OpenClaw 切换到 OpenFang 的可行性、成本和收益
> **目标**：评估 ZClaw 从 ZCLAW 切换到 ZCLAW 的可行性、成本和收益
---
## 一、核心架构对比
### 1.1 当前 ZClaw 架构 (基于 OpenClaw)
### 1.1 当前 ZClaw 架构 (基于 ZCLAW)
```
┌─────────────────────────────────────────────────────────────────┐
@@ -22,7 +22,7 @@
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ OpenClaw Gateway (Node.js) │ │
│ │ ZCLAW Gateway (Node.js) │ │
│ │ ws://127.0.0.1:18789 │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │Sessions │ │Channels │ │ Config │ │ Cron │ │ │
@@ -42,11 +42,11 @@
启动时间：2-5 秒
```
### 1.2 切换后架构 (基于 OpenFang)
### 1.2 切换后架构 (基于 ZCLAW)
```
┌─────────────────────────────────────────────────────────────────┐
│ ZClaw Desktop (OpenFang) │
│ ZClaw Desktop (ZCLAW) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
@@ -57,7 +57,7 @@
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ OpenFang Kernel (Rust) │ │
│ │ ZCLAW Kernel (Rust) │ │
│ │ ws://127.0.0.1:???? │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │ Runtime │ │ Hands │ │ 16-Layer│ │ 40 │ │ │
@@ -84,7 +84,7 @@
### 2.1 功能增强
| 功能 | OpenClaw | OpenFang | 影响 |
| 功能 | ZCLAW | ZCLAW | 影响 |
|------|----------|----------|------|
| **Hands 自主系统** | ❌ 无 | ✅ 7 个 Hands | 🔥 **重大增强**：可提供自主工作流 |
| **Workflow 引擎** | ❌ 基础 Cron | ✅ 完整 Workflow | 🔥 **重大增强**：多步骤编排 |
@@ -97,7 +97,7 @@
```
┌─────────────────────────────────────────────────────────────────┐
│ OpenFang Hands 对 ZClaw 的潜在价值 │
│ ZCLAW Hands 对 ZClaw 的潜在价值 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
@@ -137,9 +137,9 @@
| 风险 | 描述 | 缓解措施 |
|------|------|----------|
| **技能迁移** | 现有 zclaw-* 插件需要重写 | OpenFang 提供迁移工具，支持 SKILL.md 格式 |
| **技能迁移** | 现有 zclaw-* 插件需要重写 | ZCLAW 提供迁移工具，支持 SKILL.md 格式 |
| **API 差异** | Gateway 协议可能不同 | 需要适配新的 WebSocket 协议 |
| **生态不成熟** | OpenFang 社区较小 | 可考虑贡献代码，建立合作关系 |
| **生态不成熟** | ZCLAW 社区较小 | 可考虑贡献代码，建立合作关系 |
---
@@ -152,7 +152,7 @@
│ 安全架构对比 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ OpenClaw (3 层) OpenFang (16 层) │
│ ZCLAW (3 层) ZCLAW (16 层) │
│ ───────────── ──────────────── │
│ │
│ ┌─────────────────┐ ┌─────────────────────────────┐ │
@@ -195,7 +195,7 @@
│ 安全性作为产品卖点 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ "基于 OpenFang 的 ZClaw 提供： │
│ "基于 ZCLAW 的 ZClaw 提供： │
│ │
│ ✅ 16 层纵深防御 - 金融级安全保障 │
│ ✅ WASM 沙箱隔离 - 代码执行安全可控 │
@@ -217,7 +217,7 @@
### 4.1 性能指标对比
| 指标 | OpenClaw | OpenFang | 提升幅度 |
| 指标 | ZCLAW | ZCLAW | 提升幅度 |
|------|----------|----------|----------|
| **冷启动时间** | 5.98s | 180ms | **33x 更快** |
| **空闲内存** | 394MB | 40MB | **90% 更少** |
@@ -233,23 +233,23 @@
│ │
│ 启动体验： │
│ ───────── │
│ OpenClaw: 点击图标 → 等待 6 秒 → 可用 │
│ OpenFang: 点击图标 → 等待 0.2 秒 → 可用 ⚡ "秒开"体验 │
│ ZCLAW: 点击图标 → 等待 6 秒 → 可用 │
│ ZCLAW: 点击图标 → 等待 0.2 秒 → 可用 ⚡ "秒开"体验 │
│ │
│ 运行时体验： │
│ ────────── │
│ OpenClaw: 后台占用 400MB+ 内存，多任务时卡顿 │
│ OpenFang: 后台占用 40MB 内存，几乎无感 💪 轻盈 │
│ ZCLAW: 后台占用 400MB+ 内存，多任务时卡顿 │
│ ZCLAW: 后台占用 40MB 内存，几乎无感 💪 轻盈 │
│ │
│ 安装体验： │
│ ───────── │
│ OpenClaw: 下载 500MB，安装 2-3 分钟 │
│ OpenFang: 下载 32MB，安装 10 秒 🚀 快速部署 │
│ ZCLAW: 下载 500MB，安装 2-3 分钟 │
│ ZCLAW: 下载 32MB，安装 10 秒 🚀 快速部署 │
│ │
│ 低配设备： │
│ ───────── │
│ OpenClaw: 8GB 以下内存设备体验差 │
│ OpenFang: 可在 4GB 内存设备流畅运行 📱 覆盖更广 │
│ ZCLAW: 8GB 以下内存设备体验差 │
│ ZCLAW: 可在 4GB 内存设备流畅运行 📱 覆盖更广 │
│ │
└─────────────────────────────────────────────────────────────────┘
@@ -264,7 +264,7 @@
| 模块 | 工作内容 | 工作量 | 风险 |
|------|----------|--------|------|
| **GatewayClient** | 适配 OpenFang WebSocket 协议 | 3-5 天 | 中 |
| **GatewayClient** | 适配 ZCLAW WebSocket 协议 | 3-5 天 | 中 |
| **插件迁移** | 重写 zclaw-* 插件 | 10-15 天 | 高 |
| **技能迁移** | 转换 SKILL.md 格式 | 2-3 天 | 低 |
| **UI 适配** | 新增 Hands/Workflow 管理界面 | 5-7 天 | 低 |
@@ -291,19 +291,19 @@
│ │
│ 1. 渐进式迁移 │
│ ───────────── │
│ • 先保持 OpenClaw 版本维护 │
│ • 并行开发 OpenFang 版本 │
│ • 先保持 ZCLAW 版本维护 │
│ • 并行开发 ZCLAW 版本 │
│ • 双版本并行运行一段时间 │
│ │
│ 2. 兼容层设计 │
│ ───────────── │
│ • 实现 OpenClaw 协议适配器 │
│ • 实现 ZCLAW 协议适配器 │
│ • 现有插件无需修改即可运行 │
│ • 逐步迁移到原生 OpenFang API │
│ • 逐步迁移到原生 ZCLAW API │
│ │
│ 3. 社区合作 │
│ ───────────── │
│ • 与 OpenFang 团队建立联系 │
│ • 与 ZCLAW 团队建立联系 │
│ • 贡献代码换取优先支持 │
│ • 参与路线图讨论 │
│ │
@@ -330,7 +330,7 @@
```
┌─────────────────────────────────────────────────────────────────┐
│ OpenFang 带来的 UX 升级 │
│ ZCLAW 带来的 UX 升级 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 场景 1：内容创作者 │
@@ -380,15 +380,15 @@
│ 产品定位变化 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 当前 (OpenClaw)： │
│ 当前 (ZCLAW)： │
│ ───────────────── │
│ "基于 OpenClaw 的 AI Agent 桌面客户端" │
│ "基于 ZCLAW 的 AI Agent 桌面客户端" │
│ 定位：个人 AI 助手 │
│ 差异化：桌面客户端、中文优化 │
│ │
│ 升级后 (OpenFang)： │
│ 升级后 (ZCLAW)： │
│ ────────────────── │
│ "基于 OpenFang 的生产级 AI Agent 桌面客户端" │
│ "基于 ZCLAW 的生产级 AI Agent 桌面客户端" │
│ 定位：生产力工具 / 企业级助手 │
│ 差异化： │
│ • 16 层金融级安全 │
@@ -440,7 +440,7 @@
├──────────────────────┼──────────────────────────────────────────┤
│ 机会 (O) │ 威胁 (T) │
├──────────────────────┼──────────────────────────────────────────┤
│ • 企业市场拓展 │ • OpenFang 项目不够成熟 │
│ • 企业市场拓展 │ • ZCLAW 项目不够成熟 │
│ • 金融/医疗行业 │ • 社区支持可能不足 │
│ • 内容创作者市场 │ • 技术路线变化风险 │
│ • 差异化竞争 │ • 用户学习成本 │
@@ -457,9 +457,9 @@
│ │
│ 阶段 1：调研验证 (1-2 周) │
│ ──────────────────────── │
│ • 深入研究 OpenFang API 文档 │
│ • 深入研究 ZCLAW API 文档 │
│ • 评估 GatewayClient 适配工作量 │
│ • 与 OpenFang 团队建立联系 │
│ • 与 ZCLAW 团队建立联系 │
│ • 评估插件迁移可行性 │
│ │
│ 阶段 2：原型验证 (2-3 周) │
@@ -471,8 +471,8 @@
│ │
│ 阶段 3：并行开发 (1-2 月) │
│ ──────────────────────── │
│ • 保持 OpenClaw 版本维护 │
│ • 并行开发 OpenFang 版本 │
│ • 保持 ZCLAW 版本维护 │
│ • 并行开发 ZCLAW 版本 │
│ • 实现插件兼容层 │
│ • 内部测试和优化 │
│ │
@@ -484,8 +484,8 @@
│ │
│ 阶段 5：正式切换 │
│ ──────────────── │
│ • 发布 OpenFang 版本为默认 │
│ • OpenClaw 版本进入维护模式 │
│ • 发布 ZCLAW 版本为默认 │
│ • ZCLAW 版本进入维护模式 │
│ • 持续优化和迭代 │
│ │
└─────────────────────────────────────────────────────────────────┘
@@ -495,17 +495,17 @@
| 条件 | 建议 |
|------|------|
| **如果追求快速迭代** | 保持 OpenClaw，关注 OpenFang 发展 |
| **如果追求企业市场** | **强烈建议切换** OpenFang |
| **如果追求差异化竞争** | **建议切换** OpenFang |
| **如果资源有限** | 保持 OpenClaw，渐进评估 |
| **如果目标是内容创作者/销售** | **强烈建议切换** OpenFang |
| **如果追求快速迭代** | 保持 ZCLAW，关注 ZCLAW 发展 |
| **如果追求企业市场** | **强烈建议切换** ZCLAW |
| **如果追求差异化竞争** | **建议切换** ZCLAW |
| **如果资源有限** | 保持 ZCLAW，渐进评估 |
| **如果目标是内容创作者/销售** | **强烈建议切换** ZCLAW |
---
## 九、结论
### 切换到 OpenFang 的核心价值
### 切换到 ZCLAW 的核心价值
```
┌─────────────────────────────────────────────────────────────────┐
@@ -523,7 +523,7 @@
└─────────────────────────────────────────────────────────────────┘
💡 总结：如果 ZClaw 的目标是成为"生产级 AI Agent 客户端"，
切换到 OpenFang 是值得投入的战略选择。
切换到 ZCLAW 是值得投入的战略选择。
```
---