zclaw_openfang/docs/knowledge-base/openfang-alignment-analysis.md

ZCLAW 与 OpenFang 对齐分析报告

日期: 2026-03-14 目的: 分析 ZClaw 项目与 OpenFang 的对齐程度 背景: 项目已从 OpenClaw 迁移到 OpenFang，实现架构统一（Rust）

---

一、迁移决策分析

1.1 为什么选择 OpenFang

维度	OpenClaw	OpenFang	优势
技术栈	Node.js/TypeScript	Rust	架构统一，性能更好
冷启动	5.98s	180ms	33x 提升
内存占用	394MB	40MB	90% 减少
安装大小	500MB	32MB	94% 减少
安全层级	3 层	16 层纵深防御	安全性大幅提升
配置格式	YAML/JSON	TOML	更清晰，Git 友好

1.2 OpenFang 与 OpenClaw 的关系

OpenFang 是基于 OpenClaw 开发的 Rust 重构版本：

• 保留了 OpenClaw 的核心功能（Gateway、Skills、Hands、Channels）
• 用 Rust 重写了整个架构，性能和安全性大幅提升
• API 设计与 OpenClaw 兼容，迁移成本低

---

二、OpenFang 核心能力

2.1 系统架构

┌─────────────────────────────────────────────────────────────────┐
│                    OpenFang Kernel (Rust)                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  📦 Crates 架构 (14 个模块)                                     │
│  ├── openfang-kernel/      # Agent 生命周期管理                  │
│  ├── openfang-runtime/     # Agent Runtime                      │
│  ├── openfang-hands/       # Hands 自主系统 (7 个)               │
│  ├── openfang-skills/      # 技能系统 (60+ 内置)                 │
│  ├── openfang-channels/    # 通道适配器 (40+)                    │
│  ├── openfang-llm/         # LLM 提供商 (27 个)                  │
│  ├── openfang-security/    # 16 层安全防护                       │
│  └── openfang-api/         # REST + WebSocket API               │
│                                                                 │
│  🤖 Hands 自主能力包                                            │
│  ├── Clip        视频处理、竖屏生成                              │
│  ├── Lead        销售线索发现                                    │
│  ├── Collector   数据收集聚合                                    │
│  ├── Predictor   预测分析                                        │
│  ├── Researcher  深度研究                                        │
│  ├── Twitter     Twitter 自动化                                  │
│  └── Browser     浏览器自动化                                    │
│                                                                 │
│  🔒 安全架构 (16 层纵深防御)                                     │
│  ├── WASM 双重计量沙箱                                          │
│  ├── Merkle 哈希链审计                                          │
│  ├── Ed25519 签名代理清单                                       │
│  ├── 信息流污染追踪                                             │
│  ├── SSRF 防护 + 机密零化                                       │
│  └── ... 共 16 层                                               │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2.2 API 端点

端点	功能	ZClaw 集成状态
/api/health	健康检查	✅ 已集成
/api/agents	Agent 管理	✅ 已集成
/api/hands	Hands 管理	✅ 已集成
/api/hands/{name}/trigger	触发 Hand	✅ 已集成
/api/workflows	Workflow 管理	✅ 已集成
/api/triggers	Trigger 管理	✅ 已集成
/api/channels	Channel 管理	✅ 已集成
/api/skills	Skills 目录	✅ 已集成
/api/usage	用量统计	✅ 已集成
/api/config	配置管理	✅ 已集成
/ws	WebSocket 流式聊天	✅ 已集成
/api/audit/logs	审计日志	❌ OpenFang 0.4.0 未实现
/api/security/status	安全状态	❌ OpenFang 0.4.0 未实现

---

三、ZClaw 当前集成状态

3.1 已完成集成

功能	实现位置	状态	说明
Gateway 客户端	gateway-client.ts	✅	WebSocket + REST API
Hands 系统	HandList.tsx, HandTaskPanel.tsx	✅	8 个 Hands，UI 已中文化
Skills 目录	skills/ 目录	✅	4 个自定义技能
Hands 配置	hands/ 目录	✅	3 个 Hand 配置文件
Workflows	WorkflowList.tsx	✅	API 已集成
Triggers	TriggersPanel.tsx	✅	API 已集成
Channels	gatewayStore.ts	✅	40 个频道
分身管理	CloneManager.tsx	✅	10 个 Agent
流式聊天	chatStore.ts	✅	WebSocket 流式响应
用量统计	UsageStats.tsx	✅	API 已集成

3.2 部分实现

功能	实现位置	状态	说明
审批系统	ApprovalsPanel.tsx	⚠️	UI 存在，待验证
调度器	SchedulerPanel.tsx	⚠️	UI 存在，待验证

3.3 OpenFang 0.4.0 未实现

功能	状态	说明
审计日志	❌ API 404	需等待 OpenFang 更新
安全状态	❌ API 404	需等待 OpenFang 更新
定时任务	❌ API 404	需等待 OpenFang 更新

---

四、对齐程度评估

整体对齐程度: ████████░░ 80%

4.1 核心能力对齐

能力	OpenFang 提供	ZClaw 集成	对齐度
Gateway	✅	✅	100%
Hands	✅	✅	90% (UI 可增强)
Skills	✅	⚠️	60% (需扩展)
Channels	✅	✅	100%
Workflows	✅	✅	80% (需编辑器)
Triggers	✅	✅	80%
安全层	✅	❌	0% (API 未实现)
审计日志	✅	❌	0% (API 未实现)

4.2 UI 对齐

功能	AutoClaw 参考	ZClaw 实现	状态
左侧三栏 Tab	分身/IM/任务	分身/HANDS/Workflow	✅ 已改进
中间聊天区	✅	✅	100%
右侧面板	Agent 面板	状态/文件/Agent	✅
设置页面	10 个页面	10 个页面	✅
中文化	部分	全部	✅ 已完成

---

五、与原偏离报告的对比

5.1 原报告的问题（基于 OpenClaw）

原报告指出的问题：

1. ❌ "架构根本性偏离 — 没有基于 OpenClaw"
2. ❌ "Skills 系统完全缺失"
3. ❌ "MCP 完全缺失"
4. ❌ "工具执行层是假的"

5.2 当前状态（基于 OpenFang）

原问题	当前状态	说明
架构偏离	✅ 已解决	基于 OpenFang Rust 架构
Skills 缺失	⚠️ 部分解决	有 4 个技能，需扩展
MCP 缺失	✅ 不适用	OpenFang 使用 Skills 系统
工具执行假	✅ 已解决	OpenFang 提供真实执行能力

---

六、待完成工作

6.1 P0 - 核心功能（必须完成）

1. Hands 增强

   • 详情弹窗 (Details Modal)
   • Requirements 状态可视化
   • 工具和指标列表展示

2. Skills 扩展

   • 添加更多技能定义
   • 技能编辑器 UI
   • 技能测试功能

6.2 P1 - 重要功能

1. Workflow 编辑器

   • 创建/编辑 Workflow
   • Visual Builder
   • 执行历史查看

2. Scheduler 完善

   • 定时任务管理
   • 事件触发器

6.3 P2 - 可延后

1. 审计日志 - 等待 OpenFang API 实现
2. 安全状态 - 等待 OpenFang API 实现
3. 高级安全特性 - 16 层安全可视化

---

七、结论

7.1 迁移成功

ZClaw 已成功从 OpenClaw 迁移到 OpenFang：

• ✅ 架构统一为 Rust
• ✅ 核心功能已集成
• ✅ UI 已中文化
• ✅ 主要 API 已对接

7.2 当前偏离程度

整体偏离: 20%（相比原报告的 75%）

主要原因：

1. OpenFang 部分功能未实现（审计日志、安全状态 API）
2. 部分 UI 需要增强（详情弹窗、编辑器）

7.3 下一步建议

1. 优先完成 Hands 详情弹窗和 Requirements 可视化
2. 扩展 Skills 目录，添加更多技能
3. 实现 Workflow 编辑器
4. 跟进 OpenFang 更新，集成审计日志和安全状态 API

---

报告更新: 2026-03-14 参考版本: OpenFang v0.4.0