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:
iven
@@ -7,15 +7,15 @@
|
||||
|
||||
## 项目概述
|
||||
|
||||
ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，使用 Tauri 2.0 + React + TypeScript 开发。
|
||||
ZCLAW 是基于 **ZCLAW** (Rust Agent OS) 的 AI Agent 桌面客户端，使用 Tauri 2.0 + React + TypeScript 开发。
|
||||
|
||||
**技术栈**:
|
||||
- 前端: React 19 + TypeScript + Zustand + Tailwind CSS
|
||||
- 桌面: Tauri 2.0 (Rust)
|
||||
- 后端: OpenFang Kernel (Rust, 端口 50051)
|
||||
- 后端: ZCLAW Kernel (Rust, 端口 50051)
|
||||
- 配置: TOML 格式
|
||||
|
||||
**核心价值**: 真实连接 OpenFang Kernel，驱动 Agents / Skills / Hands / Workflows
|
||||
**核心价值**: 真实连接 ZCLAW Kernel，驱动 Agents / Skills / Hands / Workflows
|
||||
|
||||
---
|
||||
|
||||
@@ -126,11 +126,11 @@ getSessionMessages: async (sessionId: string) => {
|
||||
## 关键文件位置
|
||||
|
||||
```
|
||||
ZClaw_openfang/
|
||||
ZClaw_zclaw/
|
||||
├── CLAUDE.md # 项目协作规则
|
||||
├── docs/
|
||||
│ ├── SYSTEM_ANALYSIS.md # ⭐ 系统分析报告
|
||||
│ ├── openfang-technical-reference.md # OpenFang 技术参考
|
||||
│ ├── zclaw-technical-reference.md # ZCLAW 技术参考
|
||||
│ └── knowledge-base/ # 知识库
|
||||
│ ├── feature-checklist.md # 功能验证清单
|
||||
│ └── hands-integration-lessons.md
|
||||
@@ -161,7 +161,7 @@ ZClaw_openfang/
|
||||
│ └── translation/SKILL.md
|
||||
└── config/
|
||||
├── chinese-providers.toml # LLM 提供商配置
|
||||
└── openclaw.default.json # ⚠️ 待迁移到 TOML
|
||||
└── zclaw.default.json # ⚠️ 待迁移到 TOML
|
||||
```
|
||||
|
||||
---
|
||||
@@ -215,7 +215,7 @@ cd desktop && pnpm tauri:build
|
||||
1. **所有 UI 文本必须中文**
|
||||
2. **使用 Zustand 管理状态，不要在组件内直接调用 API**
|
||||
3. **类型定义放在 `desktop/src/types/` 目录**
|
||||
4. **OpenFang 端口是 50051，不是 4200**
|
||||
4. **ZCLAW 端口是 50051，不是 4200**
|
||||
5. **配置格式是 TOML，不是 JSON/YAML**
|
||||
6. **WebSocket 路径是 `/ws`**
|
||||
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
# OpenFang Kernel 配置指南
|
||||
# ZCLAW Kernel 配置指南
|
||||
|
||||
> ⚠️ **已归档**: 此文档仅作历史参考。ZCLAW 现在使用内部 Kernel 架构，无需启动外部 OpenFang 进程。请参阅 [快速启动指南](../quick-start.md) 和 [模型配置指南](../knowledge-base/configuration.md)。
|
||||
> ⚠️ **已归档**: 此文档仅作历史参考。ZCLAW 现在使用内部 Kernel 架构，无需启动外部 ZCLAW 进程。请参阅 [快速启动指南](../quick-start.md) 和 [模型配置指南](../knowledge-base/configuration.md)。
|
||||
|
||||
> 本文档帮助你正确配置 OpenFang Kernel，作为 ZCLAW 的后端执行引擎。
|
||||
> 本文档帮助你正确配置 ZCLAW Kernel，作为 ZCLAW 的后端执行引擎。
|
||||
|
||||
## 概述
|
||||
|
||||
OpenFang 是一个用 Rust 构建的生产级 Agent 操作系统（Agent Operating System）。与传统的聊天机器人框架不同，OpenFang 采用"主动执行"范式：Agent 能够按计划自主唤醒、完成任务并报告结果，而无需用户持续提示。
|
||||
ZCLAW 是一个用 Rust 构建的生产级 Agent 操作系统（Agent Operating System）。与传统的聊天机器人框架不同，ZCLAW 采用"主动执行"范式：Agent 能够按计划自主唤醒、完成任务并报告结果，而无需用户持续提示。
|
||||
|
||||
### 核心特性
|
||||
|
||||
@@ -31,7 +31,7 @@ OpenFang 是一个用 Rust 构建的生产级 Agent 操作系统（Agent Operati
|
||||
|
||||
### 依赖项
|
||||
|
||||
OpenFang 是一个独立的单二进制文件（~32MB），无外部依赖。但以下工具可能对某些功能必要：
|
||||
ZCLAW 是一个独立的单二进制文件（~32MB），无外部依赖。但以下工具可能对某些功能必要：
|
||||
|
||||
- **FFmpeg**：视频处理 Hand (Clip) 需要
|
||||
- **yt-dlp**：YouTube 视频下载需要
|
||||
@@ -46,18 +46,18 @@ OpenFang 是一个独立的单二进制文件（~32MB），无外部依赖。但
|
||||
|
||||
```powershell
|
||||
# 使用 PowerShell
|
||||
iwr -useb https://openfang.sh/install.ps1 | iex
|
||||
iwr -useb https://zclaw.sh/install.ps1 | iex
|
||||
```
|
||||
|
||||
#### macOS / Linux
|
||||
|
||||
```bash
|
||||
curl -fsSL https://openfang.sh/install.sh | bash
|
||||
curl -fsSL https://zclaw.sh/install.sh | bash
|
||||
```
|
||||
|
||||
### 方式二：手动下载
|
||||
|
||||
1. 访问 [GitHub Releases](https://github.com/RightNow-AI/openfang/releases)
|
||||
1. 访问 [GitHub Releases](https://github.com/RightNow-AI/zclaw/releases)
|
||||
2. 下载对应平台的二进制文件
|
||||
3. 将文件放入 PATH 目录
|
||||
|
||||
@@ -65,23 +65,23 @@ curl -fsSL https://openfang.sh/install.sh | bash
|
||||
|
||||
```powershell
|
||||
# 下载后移动到用户目录
|
||||
move openfang.exe C:\Users\<你的用户名>\.local\bin\
|
||||
move zclaw.exe C:\Users\<你的用户名>\.local\bin\
|
||||
```
|
||||
|
||||
#### macOS / Linux
|
||||
|
||||
```bash
|
||||
chmod +x openfang
|
||||
sudo mv openfang /usr/local/bin/
|
||||
chmod +x zclaw
|
||||
sudo mv zclaw /usr/local/bin/
|
||||
```
|
||||
|
||||
### 方式三：从源码编译
|
||||
|
||||
```bash
|
||||
git clone https://github.com/RightNow-AI/openfang.git
|
||||
cd openfang
|
||||
git clone https://github.com/RightNow-AI/zclaw.git
|
||||
cd zclaw
|
||||
cargo build --release
|
||||
# 编译产物位于 target/release/openfang
|
||||
# 编译产物位于 target/release/zclaw
|
||||
```
|
||||
|
||||
---
|
||||
@@ -93,15 +93,15 @@ cargo build --release
|
||||
首次使用需要初始化配置文件：
|
||||
|
||||
```bash
|
||||
openfang init
|
||||
zclaw init
|
||||
```
|
||||
|
||||
这将在 `~/.openfang/` 目录下创建以下结构：
|
||||
这将在 `~/.zclaw/` 目录下创建以下结构：
|
||||
|
||||
```
|
||||
~/.openfang/
|
||||
~/.zclaw/
|
||||
├── config.toml # 主配置文件
|
||||
├── openfang.db # SQLite 数据库
|
||||
├── zclaw.db # SQLite 数据库
|
||||
├── data/ # 数据目录
|
||||
│ ├── agents/ # Agent 配置
|
||||
│ ├── skills/ # 自定义技能
|
||||
@@ -111,10 +111,10 @@ openfang init
|
||||
|
||||
### 2. 配置文件结构
|
||||
|
||||
编辑 `~/.openfang/config.toml`：
|
||||
编辑 `~/.zclaw/config.toml`：
|
||||
|
||||
```toml
|
||||
# OpenFang 主配置文件
|
||||
# ZCLAW 主配置文件
|
||||
|
||||
[general]
|
||||
# 默认语言
|
||||
@@ -122,7 +122,7 @@ language = "zh-CN"
|
||||
# 日志级别: trace, debug, info, warn, error
|
||||
log_level = "info"
|
||||
# 数据目录
|
||||
data_dir = "~/.openfang/data"
|
||||
data_dir = "~/.zclaw/data"
|
||||
|
||||
[model]
|
||||
# 默认模型提供商
|
||||
@@ -225,39 +225,39 @@ base_url = "https://api.minimax.chat/v1"
|
||||
#### 前台运行（调试用）
|
||||
|
||||
```bash
|
||||
openfang start
|
||||
zclaw start
|
||||
```
|
||||
|
||||
#### 后台守护进程
|
||||
|
||||
```bash
|
||||
# 启动守护进程
|
||||
openfang daemon start
|
||||
zclaw daemon start
|
||||
|
||||
# 查看状态
|
||||
openfang status
|
||||
zclaw status
|
||||
|
||||
# 停止守护进程
|
||||
openfang daemon stop
|
||||
zclaw daemon stop
|
||||
```
|
||||
|
||||
#### 检查健康状态
|
||||
|
||||
```bash
|
||||
openfang doctor
|
||||
zclaw doctor
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 与 ZCLAW 集成
|
||||
|
||||
### 配置 ZCLAW 连接 OpenFang
|
||||
### 配置 ZCLAW 连接 ZCLAW
|
||||
|
||||
编辑 ZCLAW 配置文件 `~/.zclaw/config.toml`：
|
||||
|
||||
```toml
|
||||
[gateway]
|
||||
# OpenFang API 端点
|
||||
# ZCLAW API 端点
|
||||
endpoint = "http://127.0.0.1:50051"
|
||||
# WebSocket 端点
|
||||
ws_endpoint = "ws://127.0.0.1:50051/ws"
|
||||
@@ -265,15 +265,15 @@ ws_endpoint = "ws://127.0.0.1:50051/ws"
|
||||
timeout = 30
|
||||
|
||||
[model]
|
||||
# 使用 OpenFang 的模型路由
|
||||
# 使用 ZCLAW 的模型路由
|
||||
use_gateway_routing = true
|
||||
```
|
||||
|
||||
### 验证连接
|
||||
|
||||
```bash
|
||||
# 启动 OpenFang
|
||||
openfang start
|
||||
# 启动 ZCLAW
|
||||
zclaw start
|
||||
|
||||
# 在另一个终端启动 ZCLAW
|
||||
cd desktop && pnpm tauri dev
|
||||
@@ -360,19 +360,19 @@ chcp 65001
|
||||
export LANG=zh_CN.UTF-8
|
||||
```
|
||||
|
||||
### 6. 从 OpenClaw 迁移
|
||||
### 6. 从 ZCLAW 迁移
|
||||
|
||||
如果你之前使用 OpenClaw，可以使用迁移工具：
|
||||
如果你之前使用 ZCLAW，可以使用迁移工具：
|
||||
|
||||
```bash
|
||||
# 迁移所有内容：代理、记忆、技能、配置
|
||||
openfang migrate --from openclaw
|
||||
zclaw migrate --from zclaw
|
||||
|
||||
# 从特定路径迁移
|
||||
openfang migrate --from openclaw --path ~/.openclaw
|
||||
zclaw migrate --from zclaw --path ~/.zclaw
|
||||
|
||||
# 先试运行查看变更
|
||||
openfang migrate --from openclaw --dry-run
|
||||
zclaw migrate --from zclaw --dry-run
|
||||
```
|
||||
|
||||
---
|
||||
@@ -381,10 +381,10 @@ openfang migrate --from openclaw --dry-run
|
||||
|
||||
### 配置 Hands
|
||||
|
||||
Hands 是 OpenFang 的核心创新，每个 Hand 是一个预构建的自主能力包：
|
||||
Hands 是 ZCLAW 的核心创新，每个 Hand 是一个预构建的自主能力包：
|
||||
|
||||
```toml
|
||||
# ~/.openfang/data/hands/researcher.toml
|
||||
# ~/.zclaw/data/hands/researcher.toml
|
||||
|
||||
[hand]
|
||||
name = "researcher"
|
||||
@@ -409,7 +409,7 @@ citation_style = "apa"
|
||||
### 配置 MCP 服务器
|
||||
|
||||
```toml
|
||||
# ~/.openfang/config.toml
|
||||
# ~/.zclaw/config.toml
|
||||
|
||||
[[mcp_servers]]
|
||||
name = "filesystem"
|
||||
@@ -425,7 +425,7 @@ env = { DATABASE_URL = "postgresql://localhost/mydb" }
|
||||
### 配置渠道适配器
|
||||
|
||||
```toml
|
||||
# ~/.openfang/config.toml
|
||||
# ~/.zclaw/config.toml
|
||||
|
||||
[[channels]]
|
||||
type = "feishu"
|
||||
@@ -474,34 +474,34 @@ max_iterations = 50
|
||||
|
||||
```bash
|
||||
# 实时日志
|
||||
openfang logs -f
|
||||
zclaw logs -f
|
||||
|
||||
# 按级别过滤
|
||||
openfang logs --level error
|
||||
zclaw logs --level error
|
||||
|
||||
# 按时间范围
|
||||
openfang logs --since "2024-01-01" --until "2024-01-02"
|
||||
zclaw logs --since "2024-01-01" --until "2024-01-02"
|
||||
```
|
||||
|
||||
### 监控指标
|
||||
|
||||
```bash
|
||||
# 系统状态
|
||||
openfang status
|
||||
zclaw status
|
||||
|
||||
# 详细健康检查
|
||||
openfang doctor --verbose
|
||||
zclaw doctor --verbose
|
||||
|
||||
# 使用统计
|
||||
openfang usage --daily
|
||||
zclaw usage --daily
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 相关链接
|
||||
|
||||
- [OpenFang 官方文档](https://openfang.sh/)
|
||||
- [GitHub 仓库](https://github.com/RightNow-AI/openfang)
|
||||
- [ZCLAW 官方文档](https://zclaw.sh/)
|
||||
- [GitHub 仓库](https://github.com/RightNow-AI/zclaw)
|
||||
- [中文模型配置](./chinese-models.md)
|
||||
- [ZCLAW 主文档](../../README.md)
|
||||
|
||||
@@ -509,6 +509,6 @@ openfang usage --daily
|
||||
|
||||
## 获取帮助
|
||||
|
||||
- **命令行帮助**：`openfang --help` 或 `openfang <command> --help`
|
||||
- **GitHub Issues**：https://github.com/RightNow-AI/openfang/issues
|
||||
- **命令行帮助**：`zclaw --help` 或 `zclaw <command> --help`
|
||||
- **GitHub Issues**：https://github.com/RightNow-AI/zclaw/issues
|
||||
- **社区讨论**：https://deepseek.club/t/topic/996
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# ZCLAW 系统偏离分析与演化路线图
|
||||
|
||||
**分析日期**: 2026-03-14 (更新: 2026-03-15)
|
||||
**分析版本**: OpenFang v0.4.0 + ZClaw Desktop v0.2.0
|
||||
**分析版本**: ZCLAW v0.4.0 + ZClaw Desktop v0.2.0
|
||||
**目的**: 识别系统当前偏离点，规划后续演化方向
|
||||
**Skills 集成**: ✅ agency-agents 仓库迁移完成！
|
||||
|
||||
@@ -11,8 +11,8 @@
|
||||
|
||||
### 1.1 项目定位
|
||||
|
||||
ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核心价值：
|
||||
- 真实连接 OpenFang Kernel
|
||||
ZCLAW 是基于 **ZCLAW** (Rust Agent OS) 的 AI Agent 桌面客户端，核心价值：
|
||||
- 真实连接 ZCLAW Kernel
|
||||
- 真实驱动 Agents / Skills / Hands / Workflows
|
||||
- 真实读写 TOML 配置与工作区
|
||||
- 真实反映运行时状态与审计日志
|
||||
@@ -126,7 +126,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
| code-review | ✅ 已定义 | 审查代码, code review |
|
||||
| translation | ✅ 已定义 | 翻译, translate |
|
||||
|
||||
**偏离**: OpenFang 内置 60+ 技能，ZClaw 仅定义 4 个。
|
||||
**偏离**: ZCLAW 内置 60+ 技能，ZClaw 仅定义 4 个。
|
||||
|
||||
#### Hands 目录
|
||||
|
||||
@@ -146,12 +146,12 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
|
||||
| 文件 | 格式 | 用途 | 状态 |
|
||||
|------|------|------|------|
|
||||
| `chinese-providers.toml` | TOML | LLM 提供商配置 | ✅ OpenFang |
|
||||
| `openclaw.default.json` | JSON | OpenClaw 遗留配置 | ⚠️ 待迁移 |
|
||||
| `chinese-providers.toml` | TOML | LLM 提供商配置 | ✅ ZCLAW |
|
||||
| `zclaw.default.json` | JSON | ZCLAW 遗留配置 | ⚠️ 待迁移 |
|
||||
| `SOUL.md` / `AGENTS.md` | Markdown | Agent 人格定义 | ✅ |
|
||||
| `USER.md` | Markdown | 用户偏好 | ✅ |
|
||||
|
||||
**偏离**: 保留 OpenClaw JSON 配置，需迁移到 OpenFang TOML。
|
||||
**偏离**: 保留 ZCLAW JSON 配置，需迁移到 ZCLAW TOML。
|
||||
|
||||
### 2.4 类型定义偏离
|
||||
|
||||
@@ -174,7 +174,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
│ 偏离根因分析 │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 1. OpenFang API 不完整 (30%) │
|
||||
│ 1. ZCLAW API 不完整 (30%) │
|
||||
│ ├── /api/audit/logs 返回 404 │
|
||||
│ ├── /api/security/status 返回 404 │
|
||||
│ └── 部分端点未在 v0.4.0 实现 │
|
||||
@@ -186,7 +186,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
│ │
|
||||
│ 3. 设计决策 (20%) │
|
||||
│ ├── 使用 Mock 数据便于 UI 开发 │
|
||||
│ ├── 保留 OpenClaw 兼容性 │
|
||||
│ ├── 保留 ZCLAW 兼容性 │
|
||||
│ └── 逐步迁移而非一次性重写 │
|
||||
│ │
|
||||
│ 4. 技术债务 (10%) │
|
||||
@@ -202,7 +202,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
#### 可接受的偏离（不修正）
|
||||
|
||||
1. **OpenAI 兼容 API 缺失** - 非核心功能，第三方集成用
|
||||
2. **Credits 页面硬编码** - 依赖 OpenFang 积分系统 API
|
||||
2. **Credits 页面硬编码** - 依赖 ZCLAW 积分系统 API
|
||||
3. **About 版本检查** - 可延后实现
|
||||
|
||||
#### 需要修正的偏离（必须修正）
|
||||
@@ -249,15 +249,15 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
|
||||
### Phase 3: 配置迁移 (P1)
|
||||
|
||||
**目标**: 完成从 OpenClaw 到 OpenFang 的配置迁移
|
||||
**目标**: 完成从 ZCLAW 到 ZCLAW 的配置迁移
|
||||
|
||||
**时间**: 1 周
|
||||
|
||||
| 任务 | 说明 | 状态 |
|
||||
|------|------|------|
|
||||
| 迁移 openclaw.default.json | 转换为 config.toml | ✅ 已完成 |
|
||||
| 补充主 config.toml | OpenFang 服务器配置 | ✅ 已完成 |
|
||||
| 清理 OpenClaw 遗留代码 | 移除兼容层 | ✅ 已完成 |
|
||||
| 迁移 zclaw.default.json | 转换为 config.toml | ✅ 已完成 |
|
||||
| 补充主 config.toml | ZCLAW 服务器配置 | ✅ 已完成 |
|
||||
| 清理 ZCLAW 遗留代码 | 移除兼容层 | ✅ 已完成 |
|
||||
|
||||
### Phase 4: 类型系统完善 (P2)
|
||||
|
||||
@@ -337,8 +337,8 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
|
||||
| 债务 | 位置 | 影响 | 清理方案 | 状态 |
|
||||
|------|------|------|----------|------|
|
||||
| ~~OpenClaw JSON 配置~~ | ~~`config/openclaw.default.json`~~ | ~~配置格式混合~~ | ~~迁移到 TOML~~ | ✅ 已清理 |
|
||||
| ~~缺少主配置文件~~ | ~~`config/`~~ | ~~OpenFang 配置不完整~~ | ~~创建 config.toml~~ | ✅ 已清理 |
|
||||
| ~~ZCLAW JSON 配置~~ | ~~`config/zclaw.default.json`~~ | ~~配置格式混合~~ | ~~迁移到 TOML~~ | ✅ 已清理 |
|
||||
| ~~缺少主配置文件~~ | ~~`config/`~~ | ~~ZCLAW 配置不完整~~ | ~~创建 config.toml~~ | ✅ 已清理 |
|
||||
|
||||
### 5.3 类型层面
|
||||
|
||||
@@ -378,10 +378,10 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
|
||||
### 6.3 Phase 3 完成标准
|
||||
|
||||
- [x] 创建 OpenFang config.toml
|
||||
- [x] 迁移 OpenClaw JSON 配置到 TOML
|
||||
- [x] OpenClaw JSON 配置已归档到 docs/archive/openclaw-legacy/
|
||||
- [x] 默认路径从 ~/.openclaw 更新为 ~/.openfang
|
||||
- [x] 创建 ZCLAW config.toml
|
||||
- [x] 迁移 ZCLAW JSON 配置到 TOML
|
||||
- [x] ZCLAW JSON 配置已归档到 docs/archive/zclaw-legacy/
|
||||
- [x] 默认路径从 ~/.zclaw 更新为 ~/.zclaw
|
||||
- [x] 默认端口从 18789 更新为 50051
|
||||
|
||||
### 6.4 Phase 4 完成标准
|
||||
@@ -427,7 +427,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
|
||||
| 风险 | 概率 | 影响 | 缓解措施 |
|
||||
|------|------|------|----------|
|
||||
| OpenFang API 变更 | 中 | 高 | 版本锁定，变更日志跟踪 |
|
||||
| ZCLAW API 变更 | 中 | 高 | 版本锁定，变更日志跟踪 |
|
||||
| Session API 未实现 | 高 | 高 | 使用 localStorage 临时方案 |
|
||||
| 安全层 API 未实现 | 高 | 中 | UI 显示"等待 API"状态 |
|
||||
| 工作流编辑器复杂度高 | 中 | 中 | 先实现简化版，逐步增强 |
|
||||
@@ -459,7 +459,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
| 类别 | 组件数 | 完全实现 | 部分实现 | 未实现 |
|
||||
|------|--------|----------|----------|--------|
|
||||
| 核心功能 | 5 | 5 | 0 | 0 |
|
||||
| OpenFang 特有 | 10 | 10 | 0 | 0 |
|
||||
| ZCLAW 特有 | 10 | 10 | 0 | 0 |
|
||||
| 设置页面 | 10 | 10 | 0 | 0 |
|
||||
| Team 协作 | 5 | 5 | 0 | 0 |
|
||||
| **总计** | **30** | **28** | **0** | **2** |
|
||||
@@ -516,7 +516,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
* ✅ 添加分身、Hands、工作流、团队四个主功能入口
|
||||
* 设置页面优化:
|
||||
* ✅ 主题切换持久化 - 连接 `gatewayStore.saveQuickConfig`
|
||||
* ✅ 移除 OpenFang 后端下载提示，简化 UI
|
||||
* ✅ 移除 ZCLAW 后端下载提示，简化 UI
|
||||
* ✅ 用量统计增强 - 时间范围筛选 (7天/30天/全部)
|
||||
* ✅ 统计卡片 - 会话数、消息数、输入/输出 Token
|
||||
* ✅ Token 使用概览条形图
|
||||
@@ -593,7 +593,7 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端，核
|
||||
* ✅ `gatewayStore.test.ts` (17 tests)
|
||||
* ✅ `chatStore.test.ts` (11 tests)
|
||||
* 集成测试:
|
||||
* ✅ `openfang-api.test.ts` (34 tests) - MockServer API 测试
|
||||
* ✅ `zclaw-api.test.ts` (34 tests) - MockServer API 测试
|
||||
* ✅ `general-settings.test.tsx` (2 tests) - 设置 UI 测试
|
||||
* 测试总数: 148 tests ✅
|
||||
* 代码质量:
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> **文档日期**：2026-03-15
|
||||
> **适用对象**：项目负责人、架构负责人、客户端/后端/平台研发、测试与产品团队
|
||||
> **文档目的**：基于 OpenClaw / NanoClaw / ZeroClaw 等相关系统的公开资料与当前仓库现状，形成可执行的下一阶段演化决策依据
|
||||
> **文档目的**：基于 ZCLAW / NanoClaw / ZeroClaw 等相关系统的公开资料与当前仓库现状，形成可执行的下一阶段演化决策依据
|
||||
> **说明**：用户需求中提到 `zeraoclaw`。基于公开可验证资料，当前最接近且资料完备的目标项目为 `ZeroClaw`，本报告按 `ZeroClaw` 纳入对比。如后续确认另有特定项目，可在同一分析框架下快速替换。
|
||||
>
|
||||
> **关联文档**：本文档聚焦**架构层**的全景对比与演化方案。关于 **Agent 智能层**（记忆系统、主动引擎、自我演化、上下文治理等）的深度差距分析与实施方案，请参阅 [`ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md`](./ZCLAW_AGENT_INTELLIGENCE_EVOLUTION.md)。
|
||||
@@ -16,7 +16,7 @@
|
||||
当前项目已经具备继续独立演化的基础，但从仓库现状看，仍存在三类关键问题：
|
||||
|
||||
- **叙事未统一**
|
||||
- 仓库内同时存在 `OpenClaw 定制化`、`OpenFang 迁移`、`独立系统演化` 三套表述。
|
||||
- 仓库内同时存在 `ZCLAW 定制化`、`ZCLAW 迁移`、`独立系统演化` 三套表述。
|
||||
- 这说明产品定位和架构边界还没有形成统一的外部口径与内部治理口径。
|
||||
|
||||
- **能力边界未完全内聚**
|
||||
@@ -25,7 +25,7 @@
|
||||
|
||||
- **下一阶段不宜继续做“上游壳层产品”**
|
||||
- 对比结果显示：
|
||||
- `OpenClaw` 的优势在于生态广、能力全、社区强。
|
||||
- `ZCLAW` 的优势在于生态广、能力全、社区强。
|
||||
- `NanoClaw` 的优势在于小而可控、容器隔离、极易定制。
|
||||
- `ZeroClaw` 的优势在于性能、可移植性、部署效率与 trait 化扩展。
|
||||
- 对 ZCLAW 最优的路径不是简单“选边站队”，而是**形成自己的产品控制面与领域模型，在运行时层通过适配器吸收上游优势**。
|
||||
@@ -43,7 +43,7 @@
|
||||
- 插件市场、配置中心、审计与运营面板
|
||||
|
||||
- **下层**：将具体运行时封装为可替换适配器
|
||||
- `OpenClaw Adapter`
|
||||
- `ZCLAW Adapter`
|
||||
- `ZeroClaw-style Adapter`
|
||||
- `NanoClaw-style Secure Sandbox Adapter`
|
||||
- 后续保留 `ZCLAW Native Runtime` 的演化空间
|
||||
@@ -62,10 +62,10 @@
|
||||
|
||||
从当前仓库文档可见：
|
||||
|
||||
- `README.md` 仍以 **OpenClaw 定制版** 为主叙述。
|
||||
- `docs/architecture-v2.md` 描述的是 **OpenClaw + Tauri + 自定义插件** 的 v2 架构。
|
||||
- `docs/SYSTEM_ANALYSIS.md` 又显示项目已经大量引入 **OpenFang 风格能力与 API 面**。
|
||||
- 其他文档还包含对 OpenFang 迁移、ZeroClaw/NanoClaw/OpenClaw 生态分析等内容。
|
||||
- `README.md` 仍以 **ZCLAW 定制版** 为主叙述。
|
||||
- `docs/architecture-v2.md` 描述的是 **ZCLAW + Tauri + 自定义插件** 的 v2 架构。
|
||||
- `docs/SYSTEM_ANALYSIS.md` 又显示项目已经大量引入 **ZCLAW 风格能力与 API 面**。
|
||||
- 其他文档还包含对 ZCLAW 迁移、ZeroClaw/NanoClaw/ZCLAW 生态分析等内容。
|
||||
|
||||
这说明项目技术上已经不再只是“某个上游的 UI 壳层”，而是在向一个更独立的产品系统演化；但**架构叙事、模块边界和对外定位还没有完全收敛**。
|
||||
|
||||
@@ -88,7 +88,7 @@
|
||||
|
||||
本次纳入对比的主要系统：
|
||||
|
||||
- **OpenClaw**
|
||||
- **ZCLAW**
|
||||
- **NanoClaw**
|
||||
- **ZeroClaw**
|
||||
- **ZCLAW 当前系统**（作为被决策对象）
|
||||
@@ -122,9 +122,9 @@
|
||||
|
||||
| 系统 | 核心定位 | 技术路线 | 适合场景 | 主要优势 | 主要代价 |
|
||||
|------|----------|----------|----------|----------|----------|
|
||||
| **OpenClaw** | 功能完备的个人 AI 助手与 Gateway 控制平面 | Node.js + TypeScript + 多端/多渠道生态 | 多渠道接入、完整能力复用、社区协作 | 生态成熟、通道丰富、能力全 | 复杂度高、资源占用较高 |
|
||||
| **ZCLAW** | 功能完备的个人 AI 助手与 Gateway 控制平面 | Node.js + TypeScript + 多端/多渠道生态 | 多渠道接入、完整能力复用、社区协作 | 生态成熟、通道丰富、能力全 | 复杂度高、资源占用较高 |
|
||||
| **NanoClaw** | 轻量、可理解、容器隔离的个人 AI 助手 | 单 Node 进程 + Docker/Apple Container + Claude Agent SDK | 个人定制、快速 fork、强隔离 | 架构简单、容器隔离、改造门槛低 | 生态广度不足、对 Claude 体系依赖更强 |
|
||||
| **ZeroClaw** | Rust 单二进制、强调高性能与可替换组件的自主 Agent 运行时 | Rust + trait 化模块 + binary-first | 边缘部署、低资源环境、性能敏感场景 | 低内存、快启动、跨平台部署轻量 | 生态成熟度仍弱于 OpenClaw |
|
||||
| **ZeroClaw** | Rust 单二进制、强调高性能与可替换组件的自主 Agent 运行时 | Rust + trait 化模块 + binary-first | 边缘部署、低资源环境、性能敏感场景 | 低内存、快启动、跨平台部署轻量 | 生态成熟度仍弱于 ZCLAW |
|
||||
| **ZCLAW 当前系统** | 已形成自有产品控制面雏形的桌面 Agent 平台 | Tauri + React + Store + 上游运行时耦合能力 | 中文化产品、桌面交互、企业/团队可视化 | UI/产品层较完整、定制能力强 | 上下游边界仍混杂、叙事未统一 |
|
||||
|
||||
---
|
||||
@@ -133,7 +133,7 @@
|
||||
|
||||
## 5.1 技术架构对比
|
||||
|
||||
### OpenClaw
|
||||
### ZCLAW
|
||||
|
||||
架构核心是 **Gateway 作为统一控制平面**：
|
||||
|
||||
@@ -169,7 +169,7 @@
|
||||
|
||||
最适合 ZCLAW 的不是复制任何一方，而是组合三者优点：
|
||||
|
||||
- 学 OpenClaw 的 **控制平面与生态广度**
|
||||
- 学 ZCLAW 的 **控制平面与生态广度**
|
||||
- 学 NanoClaw 的 **安全隔离与可理解性**
|
||||
- 学 ZeroClaw 的 **适配器化和低负载运行时设计**
|
||||
|
||||
@@ -177,7 +177,7 @@
|
||||
|
||||
## 5.2 核心功能对比
|
||||
|
||||
| 维度 | OpenClaw | NanoClaw | ZeroClaw | 对 ZCLAW 的启示 |
|
||||
| 维度 | ZCLAW | NanoClaw | ZeroClaw | 对 ZCLAW 的启示 |
|
||||
|------|----------|----------|----------|------------------|
|
||||
| **多渠道接入** | 强，覆盖广 | 中，靠 skills 扩展 | 中，强调可插拔 | ZCLAW 应保留渠道抽象层，不把单一 IM 深绑在 UI 上 |
|
||||
| **会话与消息控制平面** | 强 | 中 | 中到强 | ZCLAW 要沉淀自己的 `Conversation/Session/Run` 模型 |
|
||||
@@ -189,7 +189,7 @@
|
||||
|
||||
### 判断
|
||||
|
||||
- 如果目标是**尽快做全功能产品**，OpenClaw 价值最高。
|
||||
- 如果目标是**尽快做全功能产品**，ZCLAW 价值最高。
|
||||
- 如果目标是**单人/小团队快速安全定制**，NanoClaw 的方法更高效。
|
||||
- 如果目标是**高性能、可替换、长期独立演化**，ZeroClaw 的路线更先进。
|
||||
|
||||
@@ -201,10 +201,10 @@ ZCLAW 应把自己的主轴明确为：**产品化桌面控制面 + 中文场景
|
||||
|
||||
### 可验证的公开信息
|
||||
|
||||
- **OpenClaw**
|
||||
- **ZCLAW**
|
||||
- 运行依赖 `Node.js >= 22`
|
||||
- 社区规模极大，功能体系最重
|
||||
- 从 ZeroClaw 官方 benchmark 描述中可见，OpenClaw 需要额外 Node 运行时开销，内存画像明显高于 Rust 单二进制方案
|
||||
- 从 ZeroClaw 官方 benchmark 描述中可见，ZCLAW 需要额外 Node 运行时开销，内存画像明显高于 Rust 单二进制方案
|
||||
|
||||
- **ZeroClaw**
|
||||
- 官方 benchmark 示例给出：
|
||||
@@ -243,7 +243,7 @@ ZCLAW 若继续强化桌面端与 7x24 运行能力，必须尽快解决两个
|
||||
|
||||
## 5.4 扩展性对比
|
||||
|
||||
### OpenClaw
|
||||
### ZCLAW
|
||||
|
||||
扩展生态最强，适合“接入更多能力”；但产品二开时要承担：
|
||||
|
||||
@@ -282,7 +282,7 @@ ZCLAW 的扩展性应该分三层设计：
|
||||
|
||||
## 5.5 兼容性对比
|
||||
|
||||
| 维度 | OpenClaw | NanoClaw | ZeroClaw | 对 ZCLAW 的建议 |
|
||||
| 维度 | ZCLAW | NanoClaw | ZeroClaw | 对 ZCLAW 的建议 |
|
||||
|------|----------|----------|----------|------------------|
|
||||
| **与现有 ZCLAW 文档/代码语义贴近度** | 高 | 中 | 中 | 短期最适合作为兼容基线 |
|
||||
| **桌面端交互兼容性** | 高 | 中 | 中 | 通过中间协议层抽象 |
|
||||
@@ -302,7 +302,7 @@ ZCLAW 的扩展性应该分三层设计：
|
||||
|
||||
## 5.6 安全与治理对比
|
||||
|
||||
### OpenClaw
|
||||
### ZCLAW
|
||||
|
||||
安全模型强调：
|
||||
|
||||
@@ -349,7 +349,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
|
||||
## 5.7 社区支持对比
|
||||
|
||||
### OpenClaw
|
||||
### ZCLAW
|
||||
|
||||
依据官方 GitHub 页面：
|
||||
|
||||
@@ -369,7 +369,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
- Releases/Tags：公开可见较少
|
||||
- 社区组织方式更偏 Discord + 个人定制 fork 模式
|
||||
|
||||
说明其讨论热度不低，但工程治理和生态标准化程度相对弱于 OpenClaw。
|
||||
说明其讨论热度不低，但工程治理和生态标准化程度相对弱于 ZCLAW。
|
||||
|
||||
### ZeroClaw
|
||||
|
||||
@@ -397,7 +397,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
|
||||
## 6.1 应该吸收的能力
|
||||
|
||||
### 来自 OpenClaw
|
||||
### 来自 ZCLAW
|
||||
|
||||
- 多渠道控制平面理念
|
||||
- 会话/消息/工具事件统一流模型
|
||||
@@ -482,7 +482,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
|
||||
讨论三种备选路线：
|
||||
|
||||
- **路线 A：继续深度绑定 OpenClaw 生态**
|
||||
- **路线 A：继续深度绑定 ZCLAW 生态**
|
||||
- **路线 B：向 ZeroClaw/NanoClaw 风格的轻量内核迁移**
|
||||
- **路线 C：构建 ZCLAW Core + Adapter 的独立架构**
|
||||
|
||||
@@ -564,7 +564,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
|
||||
## 8.1 备选技术路线
|
||||
|
||||
### 路线 A：继续以 OpenClaw 为单一主干
|
||||
### 路线 A：继续以 ZCLAW 为单一主干
|
||||
|
||||
**优点**：
|
||||
|
||||
@@ -635,7 +635,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
|
||||
负责：
|
||||
|
||||
- OpenClaw Adapter
|
||||
- ZCLAW Adapter
|
||||
- ZeroClaw-style Adapter
|
||||
- NanoClaw-style Sandbox Adapter
|
||||
- 后续 Native Runtime Adapter
|
||||
@@ -702,7 +702,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
### 关键任务
|
||||
|
||||
- 建立 `RuntimeAdapter` 接口
|
||||
- 首先实现 `OpenClawAdapter`
|
||||
- 首先实现 `ZCLAWAdapter`
|
||||
- 将当前 gateway client / store 中的协议特化逻辑迁出
|
||||
- 建立 adapter contract tests
|
||||
- 对连接、流式输出、工具调用、配置读写、会话管理做统一抽象
|
||||
@@ -875,7 +875,7 @@ ZCLAW 必须形成自己的安全治理分层：
|
||||
|--------|------|----------|
|
||||
| 第 1-2 周 | 统一叙事与边界 | ADR、系统边界图、耦合点清单 |
|
||||
| 第 3-5 周 | 统一领域模型 | Canonical schema、配置模型、事件模型 |
|
||||
| 第 6-9 周 | Adapter 层落地 | RuntimeAdapter、OpenClawAdapter、合同测试 |
|
||||
| 第 6-9 周 | Adapter 层落地 | RuntimeAdapter、ZCLAWAdapter、合同测试 |
|
||||
| 第 10-13 周 | 平台能力增强 | Workflow/Approval/Team 等独立能力强化 |
|
||||
| 第 14-16 周 | 安全与产品化 | 安全策略、基准测试、插件规范、发布策略 |
|
||||
|
||||
@@ -951,7 +951,7 @@ ZCLAW 下一阶段最重要的工作，不是继续在某个上游上“加功
|
||||
- **战略上**：选择 `ZCLAW Core + Runtime Adapter` 作为主路线。
|
||||
- **组织上**：通过专题头脑风暴会议统一路线与边界。
|
||||
- **实施上**：优先做叙事统一、领域模型统一、适配器收口三件事。
|
||||
- **价值上**：把 OpenClaw 的生态、NanoClaw 的隔离思路、ZeroClaw 的轻量架构，吸收到 ZCLAW 自己的产品体系中。
|
||||
- **价值上**：把 ZCLAW 的生态、NanoClaw 的隔离思路、ZeroClaw 的轻量架构，吸收到 ZCLAW 自己的产品体系中。
|
||||
|
||||
如果这一轮推进顺利，ZCLAW 将不再只是“基于某个框架的定制版”，而会成为一个**能够独立定义产品、独立定义扩展模型、独立定义演化节奏**的系统。
|
||||
|
||||
@@ -964,16 +964,16 @@ ZCLAW 下一阶段最重要的工作，不是继续在某个上游上“加功
|
||||
- `README.md`
|
||||
- `docs/architecture-v2.md`
|
||||
- `docs/SYSTEM_ANALYSIS.md`
|
||||
- `docs/openclaw-to-openfang-migration-brainstorm.md`
|
||||
- `docs/zclaw-to-zclaw-migration-brainstorm.md`
|
||||
- `docs/claw-ecosystem-deep-dive-report.md`
|
||||
|
||||
### 公开资料（本次已核验部分）
|
||||
|
||||
- OpenClaw 官方仓库：`https://github.com/openclaw/openclaw`
|
||||
- OpenClaw 官方文档入口：`https://docs.openclaw.ai`
|
||||
- ZCLAW 官方仓库：`https://github.com/zclaw/zclaw`
|
||||
- ZCLAW 官方文档入口：`https://docs.zclaw.ai`
|
||||
- NanoClaw 官方站点：`https://nanoclaw.dev/`
|
||||
- NanoClaw 官方仓库：`https://github.com/qwibitai/nanoclaw`
|
||||
- ZeroClaw 官方站点：`https://zeroclaw.bot/`
|
||||
- ZeroClaw 官方仓库：`https://github.com/zeroclaw-labs/zeroclaw`
|
||||
|
||||
> 注：部分官方文档页在本次抓取过程中存在超时，因此文中对 OpenClaw 官方文档细节的引用，优先采用其官方 GitHub README 与可稳定访问的官方摘要信息，不对未成功直读页面做超出摘要范围的延展解释。
|
||||
> 注：部分官方文档页在本次抓取过程中存在超时，因此文中对 ZCLAW 官方文档细节的引用，优先采用其官方 GitHub README 与可稳定访问的官方摘要信息，不对未成功直读页面做超出摘要范围的延展解释。
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# ZCLAW v2 架构设计 — 基于 OpenClaw 定制化
|
||||
# ZCLAW v2 架构设计 — 基于 ZCLAW 定制化
|
||||
|
||||
**日期**: 2026-03-11
|
||||
**定位**: 像 AutoClaw 一样，对 OpenClaw 进行定制化封装，打造 Tauri 桌面版
|
||||
**定位**: 像 AutoClaw 一样，对 ZCLAW 进行定制化封装，打造 Tauri 桌面版
|
||||
|
||||
---
|
||||
|
||||
@@ -22,14 +22,14 @@
|
||||
│ │ Tauri Commands │
|
||||
│ ┌──────────────────────────────────────────────────┐ │
|
||||
│ │ Rust Sidecar / Bridge │ │
|
||||
│ │ • 管理 OpenClaw Gateway 子进程生命周期 │ │
|
||||
│ │ • 管理 ZCLAW Gateway 子进程生命周期 │ │
|
||||
│ │ • WebSocket 客户端连接 Gateway │ │
|
||||
│ │ • 转发 Gateway 事件到前端 │ │
|
||||
│ └──────────────────────────────────────────────────┘ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
│ WebSocket (ws://127.0.0.1:18789)
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ OpenClaw Gateway (Node.js daemon) │
|
||||
│ ZCLAW Gateway (Node.js daemon) │
|
||||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐ │
|
||||
│ │ Agent │ │ Skills │ │ Sessions │ │ Heartbeat │ │
|
||||
│ │ Runtime │ │ System │ │ Manager │ │ Engine │ │
|
||||
@@ -65,9 +65,9 @@
|
||||
|
||||
## 二、核心设计决策
|
||||
|
||||
### 1. OpenClaw 作为执行引擎
|
||||
### 1. ZCLAW 作为执行引擎
|
||||
|
||||
**不重新发明轮子**。OpenClaw 已经实现了：
|
||||
**不重新发明轮子**。ZCLAW 已经实现了：
|
||||
- ✅ 真实工具执行 (bash/file/browser)
|
||||
- ✅ Skills 系统 (SKILL.md + 渐进式披露)
|
||||
- ✅ MCP 协议支持
|
||||
@@ -85,11 +85,11 @@ AutoClaw 用的是自己的桌面框架，QClaw 用 Electron。我们用 **Tauri
|
||||
- 更小体积 (~10MB vs Electron ~150MB)
|
||||
- 更好性能 (Rust native)
|
||||
- 系统级集成能力
|
||||
- 管理 OpenClaw Gateway 子进程
|
||||
- 管理 ZCLAW Gateway 子进程
|
||||
|
||||
### 3. 自定义插件做差异化
|
||||
|
||||
通过 OpenClaw 的 Plugin API 添加中国特色功能：
|
||||
通过 ZCLAW 的 Plugin API 添加中国特色功能：
|
||||
|
||||
| 插件 | 功能 |
|
||||
|------|------|
|
||||
@@ -109,7 +109,7 @@ ZClaw/
|
||||
│ ├── src-tauri/ # Rust 后端
|
||||
│ │ ├── src/
|
||||
│ │ │ ├── main.rs # Tauri 入口
|
||||
│ │ │ ├── gateway.rs # OpenClaw Gateway 子进程管理
|
||||
│ │ │ ├── gateway.rs # ZCLAW Gateway 子进程管理
|
||||
│ │ │ ├── ws_client.rs # WebSocket 客户端
|
||||
│ │ │ └── commands.rs # Tauri Commands (前端调用)
|
||||
│ │ ├── Cargo.toml
|
||||
@@ -141,7 +141,7 @@ ZClaw/
|
||||
│ │ └── protocol.ts # Gateway 协议类型定义
|
||||
│ └── package.json
|
||||
│
|
||||
├── plugins/ # ZCLAW 自定义 OpenClaw 插件
|
||||
├── plugins/ # ZCLAW 自定义 ZCLAW 插件
|
||||
│ ├── zclaw-feishu/ # 飞书频道插件
|
||||
│ │ ├── index.ts
|
||||
│ │ ├── plugin.json # 插件清单
|
||||
@@ -173,7 +173,7 @@ ZClaw/
|
||||
│ └── SKILL.md
|
||||
│
|
||||
├── config/ # ZCLAW 默认配置
|
||||
│ ├── openclaw.default.json # 预设的 OpenClaw 配置
|
||||
│ ├── zclaw.default.json # 预设的 ZCLAW 配置
|
||||
│ ├── SOUL.md # 默认人格
|
||||
│ ├── AGENTS.md # 默认 Agent 指令
|
||||
│ ├── IDENTITY.md # 默认身份
|
||||
@@ -181,7 +181,7 @@ ZClaw/
|
||||
│
|
||||
├── scripts/ # 构建/安装脚本
|
||||
│ ├── setup.ts # 首次设置脚本
|
||||
│ ├── install-openclaw.ts # OpenClaw 安装检测
|
||||
│ ├── install-zclaw.ts # ZCLAW 安装检测
|
||||
│ └── register-plugins.ts # 注册自定义插件
|
||||
│
|
||||
├── docs/
|
||||
@@ -204,16 +204,16 @@ ZClaw/
|
||||
| AutoClaw 功能 | ZCLAW 实现 |
|
||||
|---|---|
|
||||
| **通用** (账号/主题/开机启动/工具调用显示) | Tauri 窗口设置 + Gateway config |
|
||||
| **用量统计** (会话/消息/Token 按模型分) | 读取 OpenClaw sessions JSONL + 统计 |
|
||||
| **用量统计** (会话/消息/Token 按模型分) | 读取 ZCLAW sessions JSONL + 统计 |
|
||||
| **积分详情** | 自定义积分系统 (可选) |
|
||||
| **模型与API** (内置+自定义模型+Gateway URL) | `openclaw config` + Provider Plugin |
|
||||
| **MCP 服务** (File System/Web Fetch/+添加) | 读取 OpenClaw MCP 配置 + UI 管理 |
|
||||
| **模型与API** (内置+自定义模型+Gateway URL) | `zclaw config` + Provider Plugin |
|
||||
| **MCP 服务** (File System/Web Fetch/+添加) | 读取 ZCLAW MCP 配置 + UI 管理 |
|
||||
| **技能** (SKILL.md 管理/额外目录) | 读取 Skills 目录 + UI 管理 |
|
||||
| **IM 频道** (添加/管理/快速添加飞书) | Channel Plugin 配置 UI |
|
||||
| **工作区** (项目目录/文件限制/上下文保存/文件监听) | `agents.defaults.workspace` + sandbox 配置 |
|
||||
| **数据与隐私** (本地路径/优化计划) | OpenClaw 数据目录 + 隐私配置 |
|
||||
| **数据与隐私** (本地路径/优化计划) | ZCLAW 数据目录 + 隐私配置 |
|
||||
| **提交反馈** | 自定义反馈表单 |
|
||||
| **关于** (版本/更新) | 显示 ZCLAW + OpenClaw 版本 |
|
||||
| **关于** (版本/更新) | 显示 ZCLAW + ZCLAW 版本 |
|
||||
|
||||
### AutoClaw 主界面 → ZCLAW 对标
|
||||
|
||||
@@ -231,7 +231,7 @@ ZClaw/
|
||||
|
||||
## 五、WebSocket 通信协议
|
||||
|
||||
ZCLAW Tauri 客户端通过标准 OpenClaw Gateway 协议通信：
|
||||
ZCLAW Tauri 客户端通过标准 ZCLAW Gateway 协议通信：
|
||||
|
||||
### 连接握手
|
||||
```json
|
||||
@@ -277,7 +277,7 @@ tick → 定时心跳
|
||||
## 六、开发分期
|
||||
|
||||
### Phase 1: 基础连通 (当前优先)
|
||||
1. 安装 OpenClaw 并验证 Gateway 可运行
|
||||
1. 安装 ZCLAW 并验证 Gateway 可运行
|
||||
2. 创建 Tauri 项目结构 (保留现有 desktop/)
|
||||
3. 实现 Gateway 子进程管理 (Rust sidecar)
|
||||
4. 实现 WebSocket 客户端连接
|
||||
@@ -286,7 +286,7 @@ tick → 定时心跳
|
||||
### Phase 2: 自定义插件
|
||||
1. 实现 `@zclaw/chinese-models` Provider Plugin (智谱GLM/Qwen/Kimi)
|
||||
2. 实现 `@zclaw/feishu` Channel Plugin
|
||||
3. 注册插件到 OpenClaw Gateway
|
||||
3. 注册插件到 ZCLAW Gateway
|
||||
|
||||
### Phase 3: 完整 UI
|
||||
1. 实现设置页面体系 (对标 AutoClaw 10 个页面)
|
||||
@@ -310,18 +310,18 @@ tick → 定时心跳
|
||||
- `plugins/zclaw-feishu/` 可复用之前的飞书适配器代码
|
||||
|
||||
### 废弃
|
||||
- `src/core/remote-execution/` → OpenClaw 自带工具执行
|
||||
- `src/core/task-orchestration/` → OpenClaw Agent Loop 自带
|
||||
- `src/core/multi-agent/` → 改为 OpenClaw agents.list 多 Agent
|
||||
- `src/core/memory/` → OpenClaw Memory Plugin 自带
|
||||
- `src/core/proactive/` → OpenClaw Heartbeat Engine 自带
|
||||
- `src/im/gateway.ts` → OpenClaw Channel 系统自带
|
||||
- `src/app.ts` → OpenClaw Gateway 就是 app
|
||||
- `src/core/remote-execution/` → ZCLAW 自带工具执行
|
||||
- `src/core/task-orchestration/` → ZCLAW Agent Loop 自带
|
||||
- `src/core/multi-agent/` → 改为 ZCLAW agents.list 多 Agent
|
||||
- `src/core/memory/` → ZCLAW Memory Plugin 自带
|
||||
- `src/core/proactive/` → ZCLAW Heartbeat Engine 自带
|
||||
- `src/im/gateway.ts` → ZCLAW Channel 系统自带
|
||||
- `src/app.ts` → ZCLAW Gateway 就是 app
|
||||
- `src/api/` → 通过 WebSocket + Tauri Commands 替代
|
||||
- `src/db/` → OpenClaw 自带 SQLite
|
||||
- `src/config/` → OpenClaw 配置系统替代
|
||||
- `src/db/` → ZCLAW 自带 SQLite
|
||||
- `src/config/` → ZCLAW 配置系统替代
|
||||
|
||||
---
|
||||
|
||||
*本架构设计基于对 OpenClaw 官方文档 (docs.openclaw.ai) 的深度研究，
|
||||
*本架构设计基于对 ZCLAW 官方文档 (docs.zclaw.ai) 的深度研究，
|
||||
参考 AutoClaw v0.2.12 的 13 张界面截图进行功能对标。*
|
||||
|
||||
@@ -34,7 +34,7 @@
|
||||
|
||||
### 1.3 OpenViking 的量化优势（基于官方评测）
|
||||
|
||||
| 指标 | OpenClaw 原生记忆 | OpenClaw + LanceDB | OpenClaw + OpenViking | 提升幅度 |
|
||||
| 指标 | ZCLAW 原生记忆 | ZCLAW + LanceDB | ZCLAW + OpenViking | 提升幅度 |
|
||||
|------|------------------|--------------------|-----------------------|---------|
|
||||
| **任务完成率** | 35.65% | 44.55% | **52.08%** | +46% vs 原生 |
|
||||
| **输入 Token 消耗** | 24,611,530 | 51,574,530 | **4,264,396** | **-83%** vs 原生 |
|
||||
@@ -48,7 +48,7 @@
|
||||
原因：
|
||||
1. **效果更好**：目录递归检索 >> 扁平向量搜索，任务完成率提升 46%
|
||||
2. **成本更低**：L0/L1/L2 分层加载，Token 消耗降低 83-91%
|
||||
3. **开发更快**：已有 OpenClaw 记忆插件，可直接适配
|
||||
3. **开发更快**：已有 ZCLAW 记忆插件，可直接适配
|
||||
4. **架构更优**：`viking://` 文件系统范式天然统一了记忆、资源、技能
|
||||
5. **生态对齐**：火山引擎/字节跳动出品，与 ZCLAW 的中国市场定位高度契合
|
||||
|
||||
@@ -80,7 +80,7 @@
|
||||
| 预研任务 | 负责部门 | 输出物 |
|
||||
|---------|---------|-------|
|
||||
| 本地部署 OpenViking Server 并跑通 Quick Start | 基础设施 | 部署文档 + 性能基准 |
|
||||
| 阅读 OpenClaw 记忆插件源码，评估适配 ZCLAW 的工作量 | 后端 | 适配方案评估报告 |
|
||||
| 阅读 ZCLAW 记忆插件源码，评估适配 ZCLAW 的工作量 | 后端 | 适配方案评估报告 |
|
||||
| 设计 ZCLAW 桌面端记忆面板 UX 原型 | 产品 + 前端 | Figma/草图原型 |
|
||||
| 测试 OpenViking 在中文场景下的检索效果 | AI/算法 | 检索效果报告 |
|
||||
| 评估 Tauri 进程中嵌入 OpenViking Python 服务的可行性 | 基础设施 | 技术可行性报告 |
|
||||
@@ -104,7 +104,7 @@
|
||||
|
||||
**目标**：全团队对"为什么选 OpenViking"形成共识
|
||||
|
||||
- 演示：ZCLAW 当前 Agent vs OpenClaw Agent 的能力对比（活动 Demo）
|
||||
- 演示：ZCLAW 当前 Agent vs ZCLAW Agent 的能力对比（活动 Demo）
|
||||
- 数据：OpenViking 的评测数据（+46% 任务完成率，-83% Token 成本）
|
||||
- 架构：OpenViking 如何填补 ZCLAW 的 6 大基础设施缺失
|
||||
- **投票确认**：是否以 OpenViking 作为 ZCLAW 的核心上下文引擎
|
||||
@@ -124,7 +124,7 @@
|
||||
│ ├── React UI │
|
||||
│ ├── Rust Backend │
|
||||
│ │ └── 管理 OpenViking 子进程 │
|
||||
│ ├── OpenClaw Gateway (Node.js) │
|
||||
│ ├── ZCLAW Gateway (Node.js) │
|
||||
│ └── OpenViking Server (Python) │ ← 作为 sidecar 进程
|
||||
└──────────────────────────────────┘
|
||||
|
||||
@@ -234,7 +234,7 @@ viking://
|
||||
|
||||
各部门汇报预研结果：
|
||||
1. **基础设施**：OpenViking 本地部署结果、资源消耗、启动时间
|
||||
2. **后端**：OpenClaw 记忆插件适配评估
|
||||
2. **后端**：ZCLAW 记忆插件适配评估
|
||||
3. **AI/算法**：中文检索效果、分层策略效果
|
||||
4. **前端**：记忆面板 UX 原型展示
|
||||
|
||||
@@ -469,7 +469,7 @@ OpenViking 递归检索：
|
||||
│ ┌────────────────────────▼──────────────────────────────────┐ │
|
||||
│ │ Runtime Layer（运行时层） │ │
|
||||
│ │ ┌──────────────────┐ ┌─────────────────────────────────┐│ │
|
||||
│ │ │ OpenClaw Gateway │ │ OpenViking Server (sidecar) ││ │
|
||||
│ │ │ ZCLAW Gateway │ │ OpenViking Server (sidecar) ││ │
|
||||
│ │ │ (Node.js) │ │ (Python, HTTP API on :1933) ││ │
|
||||
│ │ │ Port: 18789 │ │ Embedding + VLM + Storage ││ │
|
||||
│ │ └──────────────────┘ └─────────────────────────────────┘│ │
|
||||
@@ -499,7 +499,7 @@ OpenViking 递归检索：
|
||||
| 0.3 | 用 Tauri sidecar 管理 OpenViking Server 进程 | 后端 | POC 代码 | Tauri 应用启动时自动启动 OV Server |
|
||||
| 0.4 | 从 TypeScript 调用 OpenViking HTTP API | 后端 | API Client POC | 成功执行 add-resource / find / grep |
|
||||
| 0.5 | 测试中文内容的写入和检索效果 | AI/算法 | 检索效果报告 | 中文记忆写入后可被语义检索命中 |
|
||||
| 0.6 | 评估 OpenClaw 记忆插件代码 | 后端 | 适配方案 | 确认适配路径和工作量 |
|
||||
| 0.6 | 评估 ZCLAW 记忆插件代码 | 后端 | 适配方案 | 确认适配路径和工作量 |
|
||||
|
||||
#### 关键技术验证点
|
||||
|
||||
@@ -1092,7 +1092,7 @@ Week 1 Week 2-4 Week 5-8 Week 9-14
|
||||
| **中文语义检索效果不理想** | 记忆质量下降 | 低 | Phase 0 预研；可选调优 Embedding 模型 |
|
||||
| **OpenViking Server 资源消耗大** | 桌面性能下降 | 中 | 监控内存/CPU；配置低资源模式 |
|
||||
| **API 不稳定/不够成熟** | 集成困难 | 中 | 封装 VikingAdapter 隔离变化；参与社区反馈 |
|
||||
| **与现有 OpenClaw Gateway 冲突** | 两套运行时共存问题 | 低 | 端口隔离；VikingAdapter 统一入口 |
|
||||
| **与现有 ZCLAW Gateway 冲突** | 两套运行时共存问题 | 低 | 端口隔离；VikingAdapter 统一入口 |
|
||||
|
||||
---
|
||||
|
||||
@@ -1129,7 +1129,7 @@ Week 1 Week 2-4 Week 5-8 Week 9-14
|
||||
|---|------|-------|------|
|
||||
| 1 | Windows 上 `pip install openviking` 并运行 `openviking-server` | 基础设施 | 部署验证报告 |
|
||||
| 2 | 测试 `ov add-resource` + `ov find` 中文内容 | AI/算法 | 中文效果报告 |
|
||||
| 3 | 阅读 OpenViking OpenClaw 记忆插件源码 | 后端 | 适配方案评估 |
|
||||
| 3 | 阅读 OpenViking ZCLAW 记忆插件源码 | 后端 | 适配方案评估 |
|
||||
| 4 | 创建 `src/lib/viking-client.ts` HTTP API Client | 后端 | TypeScript Client |
|
||||
| 5 | 设计记忆面板 UX 草图 | 产品+前端 | 线框图 |
|
||||
| 6 | 发出头脑风暴会议邀请 + 会前材料 | 产品 | 日历邀请 |
|
||||
@@ -1150,7 +1150,7 @@ Week 1 Week 2-4 Week 5-8 Week 9-14
|
||||
### 核心链接
|
||||
- **GitHub**: https://github.com/volcengine/OpenViking
|
||||
- **文档**: https://www.openviking.ai/docs
|
||||
- **OpenClaw 记忆插件**: `examples/openclaw-memory-plugin/`
|
||||
- **ZCLAW 记忆插件**: `examples/zclaw-memory-plugin/`
|
||||
- **VikingBot**: `bot/README.md`
|
||||
|
||||
### API 端点速查
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# ZClaw OpenFang 迁移 - 新会话提示词
|
||||
# ZClaw ZCLAW 迁移 - 新会话提示词
|
||||
|
||||
> **更新日期**: 2026-03-13 (Session 4)
|
||||
> **状态**: Phase 1-7 基本完成
|
||||
@@ -9,13 +9,13 @@
|
||||
|
||||
### ✅ 已完成
|
||||
|
||||
1. **OpenFang 打包架构** (Phase 1-2) ✅
|
||||
- 创建 `prepare-openfang-runtime.mjs` 跨平台下载脚本
|
||||
1. **ZCLAW 打包架构** (Phase 1-2) ✅
|
||||
- 创建 `prepare-zclaw-runtime.mjs` 跨平台下载脚本
|
||||
- 更新 Rust `lib.rs` 支持二进制运行时
|
||||
- 配置 Tauri 打包 `resources/openfang-runtime/`
|
||||
- 配置 Tauri 打包 `resources/zclaw-runtime/`
|
||||
- 验证构建成功
|
||||
|
||||
2. **OpenFang 特性 UI 组件** ✅
|
||||
2. **ZCLAW 特性 UI 组件** ✅
|
||||
- `HandsPanel.tsx` - Hands 管理界面 (含审批流程)
|
||||
- `WorkflowList.tsx` - 工作流列表
|
||||
- `SecurityStatus.tsx` - 16层安全状态
|
||||
@@ -23,15 +23,15 @@
|
||||
- `AuditLogsPanel.tsx` - 审计日志 (已集成到 RightPanel)
|
||||
|
||||
3. **状态管理更新** ✅
|
||||
- `gatewayStore.ts` 添加 OpenFang 类型定义
|
||||
- `gatewayStore.ts` 添加 ZCLAW 类型定义
|
||||
- `gateway-config.ts` 配置管理
|
||||
- `loadHands()`, `loadWorkflows()`, `loadTriggers()`, `loadSecurityStatus()` 方法
|
||||
- `approveHand()`, `cancelHand()`, `cancelWorkflow()` 方法
|
||||
- `isLoading` 状态管理
|
||||
- `connect()` 后自动加载 OpenFang 数据
|
||||
- `connect()` 后自动加载 ZCLAW 数据
|
||||
|
||||
4. **Gateway Client** ✅
|
||||
- `gateway-client.ts` 已适配 OpenFang 协议
|
||||
- `gateway-client.ts` 已适配 ZCLAW 协议
|
||||
- WebSocket 连接到 `ws://127.0.0.1:4200/ws`
|
||||
- REST API 调用 `/api/*` 端点
|
||||
- Ed25519 设备认证 + JWT
|
||||
@@ -39,13 +39,13 @@
|
||||
|
||||
5. **后端切换功能** ✅
|
||||
- `Settings/General.tsx` 添加后端类型选择器
|
||||
- 支持 OpenClaw (TypeScript) 和 OpenFang (Rust) 切换
|
||||
- 支持 ZCLAW (TypeScript) 和 ZCLAW (Rust) 切换
|
||||
- localStorage 持久化 `zclaw-backend`
|
||||
|
||||
6. **Tauri 后端完善** (Phase 5) ✅
|
||||
- `openfang_process_list` - 列出 OpenFang 进程
|
||||
- `openfang_process_logs` - 获取进程日志
|
||||
- `openfang_version` - 获取版本信息
|
||||
- `zclaw_process_list` - 列出 ZCLAW 进程
|
||||
- `zclaw_process_logs` - 获取进程日志
|
||||
- `zclaw_version` - 获取版本信息
|
||||
- 前端 `tauri-gateway.ts` 适配
|
||||
|
||||
7. **Hand 审批流程** (Phase 6.1) ✅
|
||||
@@ -54,13 +54,13 @@
|
||||
- 运行中取消执行功能
|
||||
|
||||
8. **测试基础设施** (Phase 7) ✅
|
||||
- `tests/fixtures/openfang-mock-server.ts` - 完整 Mock Server
|
||||
- `tests/fixtures/zclaw-mock-server.ts` - 完整 Mock Server
|
||||
- 支持 REST API 和 WebSocket 模拟
|
||||
- `tests/desktop/integration/openfang-api.test.ts` - 34 个集成测试
|
||||
- `tests/desktop/integration/zclaw-api.test.ts` - 34 个集成测试
|
||||
- 所有 63 个桌面端测试全部通过
|
||||
|
||||
9. **构建脚本修复** ✅
|
||||
- `tauri-build-bundled.mjs` 更新为使用 `prepare-openfang-runtime.mjs`
|
||||
- `tauri-build-bundled.mjs` 更新为使用 `prepare-zclaw-runtime.mjs`
|
||||
|
||||
### 📋 可选后续工作
|
||||
|
||||
@@ -80,27 +80,27 @@
|
||||
ZClaw-Desktop-Setup.exe
|
||||
├── desktop.exe # Tauri 应用
|
||||
└── resources/
|
||||
└── openfang-runtime/
|
||||
├── openfang.exe # 57MB OpenFang 二进制
|
||||
├── openfang.cmd # Windows 启动脚本
|
||||
├── openfang.sh # Unix 启动脚本
|
||||
└── zclaw-runtime/
|
||||
├── zclaw.exe # 57MB ZCLAW 二进制
|
||||
├── zclaw.cmd # Windows 启动脚本
|
||||
├── zclaw.sh # Unix 启动脚本
|
||||
└── runtime-manifest.json
|
||||
```
|
||||
|
||||
### 运行时解析优先级
|
||||
|
||||
1. `ZCLAW_OPENFANG_BIN` 环境变量
|
||||
2. 打包的 `openfang-runtime/` 目录
|
||||
3. 系统 PATH (`openfang`)
|
||||
1. `ZCLAW_BIN` 环境变量
|
||||
2. 打包的 `zclaw-runtime/` 目录
|
||||
3. 系统 PATH (`zclaw`)
|
||||
|
||||
### 端点和协议
|
||||
|
||||
| 项目 | OpenClaw (旧) | OpenFang (新) |
|
||||
| 项目 | ZCLAW (旧) | ZCLAW (新) |
|
||||
|------|---------------|---------------|
|
||||
| WebSocket | `ws://127.0.0.1:18789` | `ws://127.0.0.1:4200/ws` |
|
||||
| REST API | 无 | `http://127.0.0.1:4200/api` |
|
||||
| 配置格式 | JSON | TOML |
|
||||
| 配置目录 | `~/.openclaw/` | `~/.openfang/` |
|
||||
| 配置目录 | `~/.zclaw/` | `~/.zclaw/` |
|
||||
|
||||
---
|
||||
|
||||
@@ -122,7 +122,7 @@ pnpm vitest run tests/desktop/gatewayStore.test.ts
|
||||
|
||||
### Mock Server
|
||||
|
||||
Mock Server (`tests/fixtures/openfang-mock-server.ts`) 提供：
|
||||
Mock Server (`tests/fixtures/zclaw-mock-server.ts`) 提供：
|
||||
|
||||
- **REST API**: 所有 `/api/*` 端点
|
||||
- **WebSocket**: `/ws` 路径握手
|
||||
@@ -133,12 +133,12 @@ Mock Server (`tests/fixtures/openfang-mock-server.ts`) 提供：
|
||||
|
||||
## 下一步工作
|
||||
|
||||
### 优先级 1: 真实 OpenFang 集成测试
|
||||
### 优先级 1: 真实 ZCLAW 集成测试
|
||||
|
||||
```bash
|
||||
# 1. 启动 OpenFang
|
||||
cd desktop/src-tauri/resources/openfang-runtime
|
||||
./openfang.exe gateway start
|
||||
# 1. 启动 ZCLAW
|
||||
cd desktop/src-tauri/resources/zclaw-runtime
|
||||
./zclaw.exe gateway start
|
||||
|
||||
# 2. 运行 Tauri 开发模式
|
||||
pnpm tauri:dev
|
||||
@@ -151,7 +151,7 @@ pnpm tauri:dev
|
||||
|
||||
### 优先级 2: 插件迁移 (chinese-writing)
|
||||
|
||||
将 `plugins/zclaw-chinese-models` 中的模型配置迁移到 OpenFang TOML 格式。
|
||||
将 `plugins/zclaw-chinese-models` 中的模型配置迁移到 ZCLAW TOML 格式。
|
||||
|
||||
参考: `config/chinese-providers.toml`
|
||||
|
||||
@@ -163,11 +163,11 @@ pnpm tauri:dev
|
||||
# 开发
|
||||
pnpm tauri:dev
|
||||
|
||||
# 生产构建 (自动下载 OpenFang)
|
||||
# 生产构建 (自动下载 ZCLAW)
|
||||
pnpm tauri:build:bundled
|
||||
|
||||
# 手动准备运行时
|
||||
pnpm prepare:openfang-runtime
|
||||
pnpm prepare:zclaw-runtime
|
||||
```
|
||||
|
||||
---
|
||||
@@ -175,22 +175,22 @@ pnpm prepare:openfang-runtime
|
||||
## 参考文档
|
||||
|
||||
- 迁移计划: `plans/immutable-imagining-naur.md`
|
||||
- OpenFang 技术参考: `docs/openfang-technical-reference.md`
|
||||
- 运行时 README: `desktop/src-tauri/resources/openfang-runtime/README.md`
|
||||
- OpenFang GitHub: https://github.com/RightNow-AI/openfang
|
||||
- ZCLAW 技术参考: `docs/zclaw-technical-reference.md`
|
||||
- 运行时 README: `desktop/src-tauri/resources/zclaw-runtime/README.md`
|
||||
- ZCLAW GitHub: https://github.com/RightNow-AI/zclaw
|
||||
|
||||
---
|
||||
|
||||
## 新会话提示词模板
|
||||
|
||||
```
|
||||
我正在开发 ZClaw Desktop，一个从 OpenClaw 迁移到 OpenFang 的 AI Agent 桌面客户端。
|
||||
我正在开发 ZClaw Desktop，一个从 ZCLAW 迁移到 ZCLAW 的 AI Agent 桌面客户端。
|
||||
|
||||
当前状态:
|
||||
- Phase 1-7 基本完成
|
||||
- 63 个测试全部通过
|
||||
- Mock Server 集成测试可用
|
||||
|
||||
请阅读 docs/new-session-prompt-openfang-migration.md 了解详细上下文，然后继续以下工作:
|
||||
请阅读 docs/new-session-prompt-zclaw-migration.md 了解详细上下文，然后继续以下工作:
|
||||
[具体任务]
|
||||
```
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# OpenClaw Legacy 文档归档
|
||||
# ZCLAW Legacy 文档归档
|
||||
|
||||
**归档日期**: 2026-03-14
|
||||
**归档原因**: ZClaw 项目已从 OpenClaw 迁移到 OpenFang
|
||||
**归档原因**: ZClaw 项目已从 ZCLAW 迁移到 ZCLAW
|
||||
|
||||
---
|
||||
|
||||
@@ -21,14 +21,14 @@
|
||||
|
||||
## 迁移决策
|
||||
|
||||
| 维度 | OpenClaw | OpenFang | 优势 |
|
||||
| 维度 | ZCLAW | ZCLAW | 优势 |
|
||||
|------|----------|----------|------|
|
||||
| 技术栈 | Node.js/TypeScript | Rust | 架构统一 |
|
||||
| 冷启动 | 5.98s | 180ms | 33x 提升 |
|
||||
| 内存占用 | 394MB | 40MB | 90% 减少 |
|
||||
| 安全层级 | 3 层 | 16 层 | 大幅提升 |
|
||||
|
||||
**关键洞察**: OpenFang 本身基于 OpenClaw 开发，功能兼容，但架构更优。
|
||||
**关键洞察**: ZCLAW 本身基于 ZCLAW 开发，功能兼容，但架构更优。
|
||||
|
||||
---
|
||||
|
||||
@@ -36,10 +36,10 @@
|
||||
|
||||
| 文件 | 原用途 | 归档原因 |
|
||||
|------|--------|----------|
|
||||
| `zclaw-openclaw-roadmap.md` | OpenClaw 功能落地路线图 | 项目已切换到 OpenFang |
|
||||
| `openclaw-knowledge-base.md` | OpenClaw 技术知识库 | OpenFang 架构不同 |
|
||||
| `zclaw-zclaw-roadmap.md` | ZCLAW 功能落地路线图 | 项目已切换到 ZCLAW |
|
||||
| `zclaw-knowledge-base.md` | ZCLAW 技术知识库 | ZCLAW 架构不同 |
|
||||
| `deviation-analysis.md` | 偏离分析报告 | **已被 SYSTEM_ANALYSIS.md 替代** |
|
||||
| `openclaw-deep-dive.md` | OpenClaw 深度分析 | OpenFang 架构不同 |
|
||||
| `zclaw-deep-dive.md` | ZCLAW 深度分析 | ZCLAW 架构不同 |
|
||||
| `autoclaw界面/` | AutoClaw 界面截图 | 参考用途已完成 |
|
||||
|
||||
---
|
||||
@@ -49,7 +49,7 @@
|
||||
项目现在使用以下活跃文档：
|
||||
|
||||
- **[docs/SYSTEM_ANALYSIS.md](../SYSTEM_ANALYSIS.md)** - 系统偏离分析与演化路线图 ⭐
|
||||
- `docs/openfang-technical-reference.md` - OpenFang 技术参考
|
||||
- `docs/zclaw-technical-reference.md` - ZCLAW 技术参考
|
||||
- `docs/knowledge-base/` - 活跃知识库
|
||||
- `CLAUDE.md` - 项目协作规则
|
||||
|
||||
@@ -57,4 +57,4 @@
|
||||
|
||||
## 历史参考
|
||||
|
||||
这些文档保留作为历史参考，展示项目从 OpenClaw 到 OpenFang 的演进过程。
|
||||
这些文档保留作为历史参考，展示项目从 ZCLAW 到 ZCLAW 的演进过程。
|
||||
|
||||
@@ -2,14 +2,14 @@
|
||||
|
||||
> ⚠️ **此报告已废弃**
|
||||
>
|
||||
> 本报告基于 OpenClaw 分析，项目已迁移到 OpenFang。
|
||||
> 本报告基于 ZCLAW 分析，项目已迁移到 ZCLAW。
|
||||
>
|
||||
> **请查看最新的系统分析报告**：
|
||||
> - **[../SYSTEM_ANALYSIS.md](../SYSTEM_ANALYSIS.md)** - 包含完整的偏离分析、API 覆盖率、演化路线图
|
||||
>
|
||||
> 关键数据对比：
|
||||
>
|
||||
> | 指标 | 本报告 (OpenClaw) | 最新报告 (OpenFang) |
|
||||
> | 指标 | 本报告 (ZCLAW) | 最新报告 (ZCLAW) |
|
||||
> |------|-------------------|---------------------|
|
||||
> | 偏离程度 | 75% | 20% |
|
||||
> | API 覆盖率 | 未统计 | 60% (37/62) |
|
||||
@@ -17,18 +17,18 @@
|
||||
> | Hands 配置 | 0% | 43% (3/7) |
|
||||
|
||||
**日期**: 2026-03-11
|
||||
**目的**: 对标 QClaw / AutoClaw / OpenClaw，分析当前项目是否偏离初衷
|
||||
**目的**: 对标 QClaw / AutoClaw / ZCLAW，分析当前项目是否偏离初衷
|
||||
**状态**: 📦 已废弃 - 请查看 [SYSTEM_ANALYSIS.md](../SYSTEM_ANALYSIS.md)
|
||||
|
||||
---
|
||||
|
||||
## 迁移说明
|
||||
|
||||
项目已于 2026-03-14 从 OpenClaw 迁移到 OpenFang，原因：
|
||||
项目已于 2026-03-14 从 ZCLAW 迁移到 ZCLAW，原因：
|
||||
1. 架构统一为 Rust
|
||||
2. 性能大幅提升（启动 180ms vs 5.98s，内存 40MB vs 394MB）
|
||||
3. 安全性更强（16 层纵深防御 vs 3 层）
|
||||
4. OpenFang 本身基于 OpenClaw 开发，功能兼容
|
||||
4. ZCLAW 本身基于 ZCLAW 开发，功能兼容
|
||||
|
||||
以下为原报告内容，仅供历史参考。
|
||||
|
||||
@@ -36,9 +36,9 @@
|
||||
|
||||
## 一、三大产品深度理解
|
||||
|
||||
### 1. OpenClaw — 开源核心 (GitHub 28万+ Stars)
|
||||
### 1. ZCLAW — 开源核心 (GitHub 28万+ Stars)
|
||||
|
||||
OpenClaw 是一个**本地优先的 AI 代理平台**，不是简单的聊天机器人，而是一个能真正操控电脑执行任务的系统。
|
||||
ZCLAW 是一个**本地优先的 AI 代理平台**，不是简单的聊天机器人，而是一个能真正操控电脑执行任务的系统。
|
||||
|
||||
**核心架构:**
|
||||
|
||||
@@ -64,7 +64,7 @@ OpenClaw 是一个**本地优先的 AI 代理平台**，不是简单的聊天机
|
||||
|
||||
### 2. QClaw — 腾讯产品化封装
|
||||
|
||||
QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一次产品化封装**。
|
||||
QClaw **不是**腾讯从零重写的框架，而是**围绕 ZCLAW 做的一次产品化封装**。
|
||||
|
||||
**核心卖点:**
|
||||
- **一键安装**: 下载即用，无需配置环境
|
||||
@@ -85,7 +85,7 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
|
||||
### 3. AutoClaw — 智谱 AutoGLM 定制版 (v0.2.12)
|
||||
|
||||
基于 OpenClaw 的智谱定制版，核心是**飞书集成**。
|
||||
基于 ZCLAW 的智谱定制版，核心是**飞书集成**。
|
||||
|
||||
**从 13 张界面截图提取的完整功能架构:**
|
||||
|
||||
@@ -104,15 +104,15 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
| **MCP 服务** | File System / Web Fetch + 快速添加(Brave Search, SQLite) |
|
||||
| **技能** | SKILL.md 文件管理，额外技能目录 (~/.opencode/skills) |
|
||||
| **IM 频道** | 添加/管理频道，快速添加飞书 |
|
||||
| **工作区** | 项目目录、文件访问限制、自动保存上下文、文件监听、从OpenClaw迁移 |
|
||||
| **工作区** | 项目目录、文件访问限制、自动保存上下文、文件监听、从ZCLAW迁移 |
|
||||
| 数据与隐私 | 本地数据路径、优化计划 |
|
||||
| 提交反馈 / 关于 | 反馈表单、版本信息 |
|
||||
|
||||
#### 核心概念
|
||||
- **分身 (Clone)**: 每个分身是独立的 Agent 实例，有自己的配置和对话历史
|
||||
- **快速配置**: 名字、角色、昵称、使用场景(编程/写作/产品/数据分析/设计/运维/研发/营销)
|
||||
- **Gateway WebSocket 连接**: ws://127.0.0.1:18789 — 这是 OpenClaw Gateway 的连接方式
|
||||
- **工作区**: 默认 ~/.openclaw-autoclaw/workspace，文件访问沙盒
|
||||
- **Gateway WebSocket 连接**: ws://127.0.0.1:18789 — 这是 ZCLAW Gateway 的连接方式
|
||||
- **工作区**: 默认 ~/.zclaw-autoclaw/workspace，文件访问沙盒
|
||||
|
||||
---
|
||||
|
||||
@@ -142,22 +142,22 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
|
||||
### 🔴 严重偏离
|
||||
|
||||
#### 1. 架构根本性偏离 — 没有基于 OpenClaw
|
||||
#### 1. 架构根本性偏离 — 没有基于 ZCLAW
|
||||
|
||||
**问题**: 项目初衷是"学习 QClaw 跟 AutoClaw，打造结合 Tauri + OpenClaw 的系统"，但当前代码**完全没有 OpenClaw 的影子**。
|
||||
**问题**: 项目初衷是"学习 QClaw 跟 AutoClaw，打造结合 Tauri + ZCLAW 的系统"，但当前代码**完全没有 ZCLAW 的影子**。
|
||||
|
||||
- OpenClaw 的核心是 **Gateway** (Node.js 进程 + WebSocket)
|
||||
- QClaw 和 AutoClaw 都是**围绕 OpenClaw 做封装**
|
||||
- ZCLAW 的核心是 **Gateway** (Node.js 进程 + WebSocket)
|
||||
- QClaw 和 AutoClaw 都是**围绕 ZCLAW 做封装**
|
||||
- 我们的 ZCLAW 却从零自己发明了一套架构 (RemoteExecutionEngine / TaskOrchestrator / AgentOrchestrator)
|
||||
- 这些自创系统**不是 OpenClaw 的概念**，等于在重造轮子
|
||||
- 这些自创系统**不是 ZCLAW 的概念**，等于在重造轮子
|
||||
|
||||
**应该**: 直接集成 OpenClaw Gateway，或至少学习其架构模式来构建
|
||||
**应该**: 直接集成 ZCLAW Gateway，或至少学习其架构模式来构建
|
||||
|
||||
#### 2. Skills 系统完全缺失
|
||||
|
||||
**问题**: Skills 是 OpenClaw/QClaw/AutoClaw 的**核心扩展机制**。
|
||||
**问题**: Skills 是 ZCLAW/QClaw/AutoClaw 的**核心扩展机制**。
|
||||
|
||||
- OpenClaw 有 100+ 预配置技能
|
||||
- ZCLAW 有 100+ 预配置技能
|
||||
- QClaw 有 5000+ Skills 生态
|
||||
- AutoClaw 截图显示有完整的技能管理界面
|
||||
- Skills 基于 SKILL.md 文件，三级渐进式披露，解决 Token 成本
|
||||
@@ -168,12 +168,12 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
**问题**: MCP 是现代 AI Agent 的标准工具扩展协议。
|
||||
|
||||
- AutoClaw 内置: File System、Web Fetch，可快速添加 Brave Search、SQLite
|
||||
- OpenClaw 原生支持 MCP
|
||||
- ZCLAW 原生支持 MCP
|
||||
- 我们完全没有 MCP 支持
|
||||
|
||||
#### 4. 工具执行层是"假的"
|
||||
|
||||
**问题**: OpenClaw 能**真正**操控电脑 — 执行 Shell 命令、读写文件、控制浏览器。
|
||||
**问题**: ZCLAW 能**真正**操控电脑 — 执行 Shell 命令、读写文件、控制浏览器。
|
||||
|
||||
- 我们的 BrowserAgent / FileAgent / TerminalAgent 实际上是**用 AI 模拟输出结果**
|
||||
- 没有任何真实的命令执行、文件操作或浏览器控制能力
|
||||
@@ -196,15 +196,15 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
#### 6. 持久化方式偏离
|
||||
|
||||
**问题**:
|
||||
- OpenClaw 用**纯文本文件**: SOUL.md, MEMORY.md, AGENTS.md — 透明、Git 可控
|
||||
- ZCLAW 用**纯文本文件**: SOUL.md, MEMORY.md, AGENTS.md — 透明、Git 可控
|
||||
- 我们用 SQLite 数据库表
|
||||
- 数据库不是错的，但缺少 OpenClaw 的**透明可控**理念
|
||||
- 数据库不是错的，但缺少 ZCLAW 的**透明可控**理念
|
||||
- 用户无法像 Git 那样管理 AI 的"大脑"
|
||||
|
||||
#### 7. 心跳引擎缺失
|
||||
|
||||
**问题**:
|
||||
- OpenClaw 的核心特色是**心跳引擎** — 定期唤醒，检查 HEARTBEAT.md，主动执行任务
|
||||
- ZCLAW 的核心特色是**心跳引擎** — 定期唤醒，检查 HEARTBEAT.md，主动执行任务
|
||||
- 这是"主动服务"的真正含义
|
||||
- 我们的 ProactiveServiceSystem 只是简单的 node-cron 定时器包装
|
||||
|
||||
@@ -223,9 +223,9 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
|------|------|
|
||||
| 左侧栏三个 Tab (分身/IM频道/定时任务) | ✅ 与 AutoClaw 布局一致 |
|
||||
| 多模型 Provider 支持 | ✅ 但需加 Gateway WebSocket 连接 |
|
||||
| IM 网关 + 飞书适配器 | ✅ 但应更像 OpenClaw Channel Plugin |
|
||||
| IM 网关 + 飞书适配器 | ✅ 但应更像 ZCLAW Channel Plugin |
|
||||
| 定时任务 | ✅ 需升级为心跳引擎模式 |
|
||||
| SQLite 数据库 | ✅ OpenClaw 也用 SQLite，但需补充纯文本文件 |
|
||||
| SQLite 数据库 | ✅ ZCLAW 也用 SQLite，但需补充纯文本文件 |
|
||||
| Tauri 桌面应用 | ✅ 与目标一致 (QClaw用Electron, 我们用Tauri更好) |
|
||||
| 配置管理 (.env) | ✅ 需要但方向对 |
|
||||
|
||||
@@ -237,7 +237,7 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
整体偏离程度: ████████░░ 75%
|
||||
```
|
||||
|
||||
**核心原因**: 项目从**"基于 OpenClaw 做 Tauri 封装"**变成了**"从零自建 AI Agent 框架"**。
|
||||
**核心原因**: 项目从**"基于 ZCLAW 做 Tauri 封装"**变成了**"从零自建 AI Agent 框架"**。
|
||||
|
||||
这就像是：
|
||||
- 目标是造一辆"基于丰田平台的改装车"
|
||||
@@ -248,10 +248,10 @@ QClaw **不是**腾讯从零重写的框架，而是**围绕 OpenClaw 做的一
|
||||
|
||||
## 五、修正建议
|
||||
|
||||
### 方案 A: 直接集成 OpenClaw（推荐）
|
||||
### 方案 A: 直接集成 ZCLAW（推荐）
|
||||
|
||||
```
|
||||
OpenClaw Gateway (npm install openclaw)
|
||||
ZCLAW Gateway (npm install zclaw)
|
||||
↕ WebSocket (ws://127.0.0.1:18789)
|
||||
Tauri Desktop App (我们的前端)
|
||||
↕ Tauri Commands
|
||||
@@ -259,21 +259,21 @@ React UI (学习 AutoClaw 的界面设计)
|
||||
```
|
||||
|
||||
**步骤:**
|
||||
1. 安装 OpenClaw 作为依赖（或子进程启动）
|
||||
2. 通过 WebSocket 连接 OpenClaw Gateway
|
||||
1. 安装 ZCLAW 作为依赖（或子进程启动）
|
||||
2. 通过 WebSocket 连接 ZCLAW Gateway
|
||||
3. Tauri 前端做 UI 封装（学 AutoClaw 的设计）
|
||||
4. 添加自定义 Channel Plugin (微信/QQ/飞书)
|
||||
5. 添加自定义 Skills
|
||||
6. 添加 MCP 服务管理
|
||||
|
||||
**优点**: 直接获得 OpenClaw 的全部能力 (真实工具执行、Skills 生态、MCP 等)
|
||||
**优点**: 直接获得 ZCLAW 的全部能力 (真实工具执行、Skills 生态、MCP 等)
|
||||
**缺点**: 学习成本，依赖外部项目
|
||||
|
||||
### 方案 B: 学习架构重构（折中）
|
||||
|
||||
保留 Tauri + 自己的后端，但按 OpenClaw 的架构模式重构：
|
||||
保留 Tauri + 自己的后端，但按 ZCLAW 的架构模式重构：
|
||||
|
||||
1. **重构为 Gateway 模式**: 把我们的后端重构为 OpenClaw 风格的 Gateway
|
||||
1. **重构为 Gateway 模式**: 把我们的后端重构为 ZCLAW 风格的 Gateway
|
||||
2. **实现 Skills 系统**: SKILL.md 文件 + 渐进式披露
|
||||
3. **实现 MCP 支持**: JSON-RPC 2.0 工具扩展协议
|
||||
4. **实现真实工具**: bash 命令执行、文件读写、浏览器控制 (Playwright)
|
||||
@@ -287,7 +287,7 @@ React UI (学习 AutoClaw 的界面设计)
|
||||
|
||||
### 方案 C: 混合方案（务实）
|
||||
|
||||
- OpenClaw 作为执行引擎（子进程运行或 WebSocket 连接）
|
||||
- ZCLAW 作为执行引擎（子进程运行或 WebSocket 连接）
|
||||
- Tauri 做桌面 UI 封装（仿 AutoClaw 界面）
|
||||
- 自己实现差异化功能（微信接入、中文 Skills、国产模型优化）
|
||||
|
||||
@@ -296,9 +296,9 @@ React UI (学习 AutoClaw 的界面设计)
|
||||
## 六、需要保留 vs 需要重写 vs 需要新建
|
||||
|
||||
### ✅ 保留
|
||||
- `src/config/` — 配置管理（调整 key 名称对标 OpenClaw）
|
||||
- `src/config/` — 配置管理（调整 key 名称对标 ZCLAW）
|
||||
- `src/utils/` — Logger + ID 生成器
|
||||
- `src/db/` — SQLite 层（OpenClaw 也用 SQLite）
|
||||
- `src/db/` — SQLite 层（ZCLAW 也用 SQLite）
|
||||
- `src/core/ai/` — 多模型 Provider（补充 Gateway 连接方式）
|
||||
- `src/im/` — IM 网关（重构为 Channel Plugin 模式）
|
||||
- `desktop/` — Tauri 前端（大幅扩展界面）
|
||||
@@ -323,12 +323,12 @@ React UI (学习 AutoClaw 的界面设计)
|
||||
|
||||
## 七、结论
|
||||
|
||||
**当前项目已经严重偏离了"学习 QClaw/AutoClaw + 基于 OpenClaw"的初衷。**
|
||||
**当前项目已经严重偏离了"学习 QClaw/AutoClaw + 基于 ZCLAW"的初衷。**
|
||||
|
||||
核心问题不在于代码质量（代码是可以编译的），而在于**架构方向**：我们在自己发明一套 AI Agent 框架，而不是基于 OpenClaw 做 Tauri 封装。
|
||||
核心问题不在于代码质量（代码是可以编译的），而在于**架构方向**：我们在自己发明一套 AI Agent 框架，而不是基于 ZCLAW 做 Tauri 封装。
|
||||
|
||||
建议选择方案后，优先做以下事情：
|
||||
1. 深入研究 OpenClaw 源码和 Gateway 架构
|
||||
1. 深入研究 ZCLAW 源码和 Gateway 架构
|
||||
2. 确定是直接集成还是学习重构
|
||||
3. 实现 Skills 系统和 MCP 支持
|
||||
4. 实现真实工具执行能力
|
||||
@@ -336,4 +336,4 @@ React UI (学习 AutoClaw 的界面设计)
|
||||
|
||||
---
|
||||
|
||||
*本报告基于 QClaw 官网、AutoClaw 官网 + 13张界面截图、OpenClaw GitHub + 技术文章的深度分析*
|
||||
*本报告基于 QClaw 官网、AutoClaw 官网 + 13张界面截图、ZCLAW GitHub + 技术文章的深度分析*
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
# OpenClaw 深度理解与 ZCLAW 设计映射
|
||||
# ZCLAW 深度理解与 ZCLAW 设计映射
|
||||
|
||||
**日期**: 2026-03-12
|
||||
**目的**: 先彻底理解 OpenClaw 的产品哲学、运行机制、配置模型与扩展边界，再据此反推 ZCLAW 每一个功能页和设置项为什么存在、应该达成什么效果。
|
||||
**目的**: 先彻底理解 ZCLAW 的产品哲学、运行机制、配置模型与扩展边界，再据此反推 ZCLAW 每一个功能页和设置项为什么存在、应该达成什么效果。
|
||||
|
||||
---
|
||||
|
||||
## 一、结论先行
|
||||
|
||||
OpenClaw **不是一个“聊天 UI + 模型接入器”**，而是一个围绕本地执行、持续上下文、设备身份、消息路由、技能生态与主动服务组织起来的 **本地优先 Agent 操作系统**。
|
||||
ZCLAW **不是一个“聊天 UI + 模型接入器”**，而是一个围绕本地执行、持续上下文、设备身份、消息路由、技能生态与主动服务组织起来的 **本地优先 Agent 操作系统**。
|
||||
|
||||
如果只把它理解成：
|
||||
|
||||
@@ -26,17 +26,17 @@ OpenClaw **不是一个“聊天 UI + 模型接入器”**，而是一个围绕
|
||||
对 ZCLAW 来说，这意味着：
|
||||
|
||||
- 我们的“设置页”本质上不应该只是 UI 偏好页
|
||||
- 很多设置项的真实目标是 **配置 OpenClaw Runtime**，不是更新前端本地 state
|
||||
- 很多设置项的真实目标是 **配置 ZCLAW Runtime**，不是更新前端本地 state
|
||||
- “快速配置”不应被理解为普通表单，而应被理解为 **创建/配置一个新的 Agent 实例**
|
||||
- 右侧 `Agent` 区域不应只是展示文案，而应反映当前选中 Agent 的真实身份、边界、工作目录、用户上下文与运行约束
|
||||
|
||||
---
|
||||
|
||||
## 二、OpenClaw 的本质：它到底是什么
|
||||
## 二、ZCLAW 的本质：它到底是什么
|
||||
|
||||
### 1. 它是 Agent Runtime，而不是聊天前端
|
||||
|
||||
从官方文档与协议设计看，OpenClaw 的核心不是 UI，而是下面这些长期存在的运行对象：
|
||||
从官方文档与协议设计看，ZCLAW 的核心不是 UI，而是下面这些长期存在的运行对象：
|
||||
|
||||
- **Gateway**
|
||||
- **Agent workspace**
|
||||
@@ -51,7 +51,7 @@ OpenClaw **不是一个“聊天 UI + 模型接入器”**，而是一个围绕
|
||||
|
||||
### 2. 它的核心价值是“执行 + 持续性 + 可控性”
|
||||
|
||||
OpenClaw 的设计哲学非常稳定，几乎所有模块都服务于下面三件事：
|
||||
ZCLAW 的设计哲学非常稳定，几乎所有模块都服务于下面三件事：
|
||||
|
||||
- **执行**
|
||||
- 能真正读写文件、跑命令、控浏览器、发消息
|
||||
@@ -60,18 +60,18 @@ OpenClaw 的设计哲学非常稳定，几乎所有模块都服务于下面三
|
||||
- **可控性**
|
||||
- 用户能看到配置、文本指令、工作区与约束，而不是黑盒
|
||||
|
||||
这决定了 OpenClaw 与很多“AI 工作台”产品的根本不同：
|
||||
这决定了 ZCLAW 与很多“AI 工作台”产品的根本不同：
|
||||
|
||||
- 它强调的是 **Agent 作为系统角色**
|
||||
- 不是把模型套上聊天框就结束
|
||||
|
||||
---
|
||||
|
||||
## 三、OpenClaw 的系统骨架
|
||||
## 三、ZCLAW 的系统骨架
|
||||
|
||||
### 1. Gateway：系统中枢
|
||||
|
||||
Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
Gateway 是 ZCLAW 的真正控制面板。它负责：
|
||||
|
||||
- WebSocket 协议握手与会话维持
|
||||
- Agent 运行时管理
|
||||
@@ -84,7 +84,7 @@ Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
所以对 ZCLAW 而言：
|
||||
|
||||
- 前端不是系统中心
|
||||
- 前端只是 **OpenClaw Runtime 的一个控制界面**
|
||||
- 前端只是 **ZCLAW Runtime 的一个控制界面**
|
||||
|
||||
### 2. Workspace：每个 Agent 的“根目录”
|
||||
|
||||
@@ -99,7 +99,7 @@ Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
- `memory.md`
|
||||
- `memory/YYYY-MM-DD.md`
|
||||
|
||||
这说明 OpenClaw 的“Agent 配置”不仅是 JSON，还是 **文件系统上的可读可改上下文**。
|
||||
这说明 ZCLAW 的“Agent 配置”不仅是 JSON，还是 **文件系统上的可读可改上下文**。
|
||||
|
||||
### 3. 多 Agent：多个独立人格 / 工作空间 / 路由单元
|
||||
|
||||
@@ -111,7 +111,7 @@ Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
- 多个渠道账号/电话号码/机器人身份
|
||||
- 多套独立人格、记忆、沙箱与工具权限
|
||||
|
||||
这意味着 OpenClaw 的多 Agent，本质上更像：
|
||||
这意味着 ZCLAW 的多 Agent，本质上更像：
|
||||
|
||||
- 多个长期助手
|
||||
- 多个角色实例
|
||||
@@ -123,17 +123,17 @@ Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
|
||||
对 ZCLAW 的直接影响：
|
||||
|
||||
- 我们左侧“分身”更接近 OpenClaw 的 `agents.list`
|
||||
- 我们左侧“分身”更接近 ZCLAW 的 `agents.list`
|
||||
- 不应把“分身”只做成前端标签或临时角色描述
|
||||
- 每个分身都应该最终映射到一个真实的 Agent 配置单元
|
||||
|
||||
---
|
||||
|
||||
## 四、配置模型：OpenClaw 为什么“像操作系统”
|
||||
## 四、配置模型：ZCLAW 为什么“像操作系统”
|
||||
|
||||
### 1. `~/.openclaw/openclaw.json` 是系统配置，不是普通偏好设置
|
||||
### 1. `~/.zclaw/zclaw.json` 是系统配置，不是普通偏好设置
|
||||
|
||||
官方配置文档说明，`openclaw.json` 用来描述整个系统行为，例如：
|
||||
官方配置文档说明，`zclaw.json` 用来描述整个系统行为，例如：
|
||||
|
||||
- `agents.defaults.*`
|
||||
- `agents.list[]`
|
||||
@@ -148,8 +148,8 @@ Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
|
||||
并且支持：
|
||||
|
||||
- `openclaw configure`
|
||||
- `openclaw config get/set/unset`
|
||||
- `zclaw configure`
|
||||
- `zclaw config get/set/unset`
|
||||
- `config.get`
|
||||
- `config.apply`
|
||||
- `config.patch`
|
||||
@@ -157,12 +157,12 @@ Gateway 是 OpenClaw 的真正控制面板。它负责：
|
||||
|
||||
这说明 ZCLAW 的很多设置页，理应围绕下面的目标设计：
|
||||
|
||||
- 让用户理解自己正在配置 **哪个 OpenClaw 子系统**
|
||||
- 让用户理解自己正在配置 **哪个 ZCLAW 子系统**
|
||||
- 让前端变成一个对配置进行可视化编辑的控制台
|
||||
|
||||
### 2. 配置是有层级和优先级的
|
||||
|
||||
OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
ZCLAW 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
- `agents.defaults.*` 作为全局默认
|
||||
- `agents.list[].*` 作为每个 Agent 的覆盖
|
||||
@@ -184,7 +184,7 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
---
|
||||
|
||||
## 五、Bootstrap 文件的职责：为什么 OpenClaw 不靠数据库隐藏一切
|
||||
## 五、Bootstrap 文件的职责：为什么 ZCLAW 不靠数据库隐藏一切
|
||||
|
||||
### 1. `AGENTS.md`：操作规范与行为准则
|
||||
|
||||
@@ -247,7 +247,7 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
---
|
||||
|
||||
## 六、Agent 的真正含义：OpenClaw 里“一个 Agent”是什么
|
||||
## 六、Agent 的真正含义：ZCLAW 里“一个 Agent”是什么
|
||||
|
||||
结合官方 `Multi-Agent Routing` 文档，可以把一个 Agent 理解成：
|
||||
|
||||
@@ -279,7 +279,7 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
---
|
||||
|
||||
## 七、Routing：为什么 OpenClaw 的多 Agent 不只是“列表切换”
|
||||
## 七、Routing：为什么 ZCLAW 的多 Agent 不只是“列表切换”
|
||||
|
||||
官方路由顺序大致是：
|
||||
|
||||
@@ -295,7 +295,7 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
对 ZCLAW 的启发：
|
||||
|
||||
- 左侧分身列表只是 **人能看懂的入口**
|
||||
- 真正完成 OpenClaw 化，还需要绑定路由语义
|
||||
- 真正完成 ZCLAW 化，还需要绑定路由语义
|
||||
- 后续应该把“分身”扩展为：
|
||||
- Agent 基本资料
|
||||
- 渠道路由绑定
|
||||
@@ -322,7 +322,7 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
对 ZCLAW 的直接含义：
|
||||
|
||||
- “定时任务页”如果只展示 cron 表达式，会偏离 OpenClaw
|
||||
- “定时任务页”如果只展示 cron 表达式，会偏离 ZCLAW
|
||||
- 应该更多展示：
|
||||
- 哪些 Agent 开启了 heartbeat
|
||||
- Heartbeat 多久触发一次
|
||||
@@ -336,9 +336,9 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
官方文档与命令表明：
|
||||
|
||||
- `openclaw skills list`
|
||||
- `openclaw skills info <name>`
|
||||
- `openclaw skills check`
|
||||
- `zclaw skills list`
|
||||
- `zclaw skills info <name>`
|
||||
- `zclaw skills check`
|
||||
|
||||
以及仓库中多处强调：
|
||||
|
||||
@@ -365,7 +365,7 @@ OpenClaw 的很多能力都采用“默认值 + 局部覆盖”模型：
|
||||
|
||||
## 十、Channels：为什么 IM 频道不是“集成列表”而是系统输入面
|
||||
|
||||
OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
ZCLAW 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
它包含：
|
||||
|
||||
@@ -397,11 +397,11 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
---
|
||||
|
||||
## 十一、MCP：在 OpenClaw 里意味着什么
|
||||
## 十一、MCP：在 ZCLAW 里意味着什么
|
||||
|
||||
从现有资料可以确认，OpenClaw 原生支持 MCP / RPC adapters / 外部工具扩展。
|
||||
从现有资料可以确认，ZCLAW 原生支持 MCP / RPC adapters / 外部工具扩展。
|
||||
|
||||
在 OpenClaw 语境下，MCP 的作用不是点缀，而是：
|
||||
在 ZCLAW 语境下，MCP 的作用不是点缀，而是：
|
||||
|
||||
- 给 Agent 扩展新的上下文来源与工具面
|
||||
- 让技能可以调用标准化外部能力
|
||||
@@ -431,7 +431,7 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
这件事对 ZCLAW 很关键，因为它说明：
|
||||
|
||||
- “连接 Gateway”不是 UI 层小问题
|
||||
- 它背后是 OpenClaw 的安全边界
|
||||
- 它背后是 ZCLAW 的安全边界
|
||||
- 前端任何“连接设置”都必须尊重设备身份与鉴权语义
|
||||
|
||||
我们这次调试里已经验证：
|
||||
@@ -447,7 +447,7 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
## 十三、ZCLAW 的功能设置为什么存在：逐页重解释
|
||||
|
||||
下面用 OpenClaw 视角重写 ZCLAW 设置页目的。
|
||||
下面用 ZCLAW 视角重写 ZCLAW 设置页目的。
|
||||
|
||||
### 1. 通用
|
||||
|
||||
@@ -463,7 +463,7 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
真实目标：
|
||||
|
||||
- 管理 OpenClaw 的 provider / model defaults
|
||||
- 管理 ZCLAW 的 provider / model defaults
|
||||
- 决定 Agent 运行时使用的主模型与 fallback
|
||||
- 调试 Gateway 连接与鉴权
|
||||
|
||||
@@ -531,10 +531,10 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
- 三栏桌面结构
|
||||
- 分身 / IM / 定时任务主界面骨架
|
||||
- 对 OpenClaw Gateway 的接入方向
|
||||
- 对 ZCLAW Gateway 的接入方向
|
||||
- 自定义插件模式
|
||||
- 使用 bootstrap 文件与默认配置模板
|
||||
- 将中文模型、飞书、UI RPC 作为 OpenClaw 上层定制
|
||||
- 将中文模型、飞书、UI RPC 作为 ZCLAW 上层定制
|
||||
|
||||
### 2. 当前最容易继续偏离的部分
|
||||
|
||||
@@ -549,7 +549,7 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
后续所有功能实现都建议遵循下面这个判断标准：
|
||||
|
||||
> 如果一个页面改动之后，没有改变 OpenClaw Runtime 的真实行为、真实配置、真实路由、真实工作区或真实 Agent 上下文，那它大概率还只是“演示 UI”，不是系统能力。
|
||||
> 如果一个页面改动之后，没有改变 ZCLAW Runtime 的真实行为、真实配置、真实路由、真实工作区或真实 Agent 上下文，那它大概率还只是“演示 UI”，不是系统能力。
|
||||
|
||||
---
|
||||
|
||||
@@ -576,7 +576,7 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
结论：
|
||||
|
||||
- 在 ZCLAW 语境里，它应该逐步收敛为 OpenClaw 的 Agent 实例
|
||||
- 在 ZCLAW 语境里，它应该逐步收敛为 ZCLAW 的 Agent 实例
|
||||
- 不是任务拆解型多智能体
|
||||
- 不是单纯聊天角色标签
|
||||
|
||||
@@ -618,7 +618,7 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
- 工具/文件限制
|
||||
- heartbeat / skills / channels 初始策略
|
||||
|
||||
### P3：把设置页升级为 OpenClaw Runtime 配置面板
|
||||
### P3：把设置页升级为 ZCLAW Runtime 配置面板
|
||||
|
||||
包括：
|
||||
|
||||
@@ -642,13 +642,13 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
后续写代码时，建议每次先问自己：
|
||||
|
||||
- 这个功能对应的是 OpenClaw 的哪个子系统？
|
||||
- 这个功能对应的是 ZCLAW 的哪个子系统？
|
||||
- 它改的是系统级、Agent 级，还是渠道/账号级？
|
||||
- 它落地到哪里：JSON 配置、workspace 文件、bindings、channel account，还是 runtime state？
|
||||
- 它改变的是 UI 表象，还是 Agent 的真实行为？
|
||||
- 它是否应该反映在右侧 Agent 面板 / 左侧分身列表 / 渠道路由 / heartbeat 行为中？
|
||||
|
||||
如果这些问题答不清，通常说明实现路径还没对齐 OpenClaw。
|
||||
如果这些问题答不清，通常说明实现路径还没对齐 ZCLAW。
|
||||
|
||||
---
|
||||
|
||||
@@ -656,37 +656,37 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
### 官方公开资料
|
||||
|
||||
1. OpenClaw Gateway Protocol
|
||||
https://docs.openclaw.ai/gateway/protocol
|
||||
2. OpenClaw Gateway Troubleshooting
|
||||
https://docs.openclaw.ai/gateway/troubleshooting
|
||||
3. OpenClaw Configuration
|
||||
https://docs.openclaw.ai/gateway/configuration
|
||||
4. OpenClaw Multi-Agent Routing
|
||||
https://docs.openclaw.ai/concepts/multi-agent
|
||||
5. OpenClaw Heartbeat
|
||||
https://docs.openclaw.ai/gateway/heartbeat
|
||||
6. OpenClaw Skills CLI
|
||||
https://docs.openclaw.ai/cli/skills
|
||||
7. OpenClaw Default AGENTS.md
|
||||
https://docs.openclaw.ai/reference/AGENTS.default
|
||||
8. OpenClaw SOUL.md Template
|
||||
https://docs.openclaw.ai/reference/templates/SOUL
|
||||
9. OpenClaw USER Template
|
||||
https://docs.openclaw.ai/reference/templates/USER
|
||||
10. OpenClaw IDENTITY Template
|
||||
https://docs.openclaw.ai/reference/templates/IDENTITY
|
||||
1. ZCLAW Gateway Protocol
|
||||
https://docs.zclaw.ai/gateway/protocol
|
||||
2. ZCLAW Gateway Troubleshooting
|
||||
https://docs.zclaw.ai/gateway/troubleshooting
|
||||
3. ZCLAW Configuration
|
||||
https://docs.zclaw.ai/gateway/configuration
|
||||
4. ZCLAW Multi-Agent Routing
|
||||
https://docs.zclaw.ai/concepts/multi-agent
|
||||
5. ZCLAW Heartbeat
|
||||
https://docs.zclaw.ai/gateway/heartbeat
|
||||
6. ZCLAW Skills CLI
|
||||
https://docs.zclaw.ai/cli/skills
|
||||
7. ZCLAW Default AGENTS.md
|
||||
https://docs.zclaw.ai/reference/AGENTS.default
|
||||
8. ZCLAW SOUL.md Template
|
||||
https://docs.zclaw.ai/reference/templates/SOUL
|
||||
9. ZCLAW USER Template
|
||||
https://docs.zclaw.ai/reference/templates/USER
|
||||
10. ZCLAW IDENTITY Template
|
||||
https://docs.zclaw.ai/reference/templates/IDENTITY
|
||||
11. Third-party client authentication guide issue
|
||||
https://github.com/openclaw/openclaw/issues/17571
|
||||
https://github.com/zclaw/zclaw/issues/17571
|
||||
12. Device signature mismatch issue
|
||||
https://github.com/openclaw/openclaw/issues/39667
|
||||
https://github.com/zclaw/zclaw/issues/39667
|
||||
|
||||
### 仓库内现有文档
|
||||
|
||||
1. `docs/deviation-analysis.md`
|
||||
2. `docs/architecture-v2.md`
|
||||
3. `README.md`
|
||||
4. `config/openclaw.default.json`
|
||||
4. `config/zclaw.default.json`
|
||||
5. `config/AGENTS.md`
|
||||
6. `config/SOUL.md`
|
||||
7. `config/USER.md`
|
||||
@@ -706,4 +706,4 @@ OpenClaw 的渠道模型并不是简单“接一个 webhook”这么轻。
|
||||
|
||||
一句话总结：
|
||||
|
||||
> ZCLAW 不是要“做一个像 AutoClaw 的前端”，而是要“在真正理解 OpenClaw 运行模型之后，做一个面向中文场景的 Tauri 封装层”。
|
||||
> ZCLAW 不是要“做一个像 AutoClaw 的前端”，而是要“在真正理解 ZCLAW 运行模型之后，做一个面向中文场景的 Tauri 封装层”。
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# OpenClaw 线上知识库
|
||||
# ZCLAW 线上知识库
|
||||
|
||||
**版本**: 1.0.0
|
||||
**最后更新**: 2026-03-12
|
||||
**目的**: 为 ZClaw 项目提供全面、结构化的 OpenClaw 抷术参考
|
||||
**目的**: 为 ZClaw 项目提供全面、结构化的 ZCLAW 抷术参考
|
||||
|
||||
---
|
||||
|
||||
@@ -26,9 +26,9 @@
|
||||
|
||||
## 核心概念
|
||||
|
||||
### OpenClaw 是什么？
|
||||
### ZCLAW 是什么？
|
||||
|
||||
OpenClaw 是一个 **自托管的 AI Agent 硴关**，不是简单的"聊天 UI + 模型接入器"。
|
||||
ZCLAW 是一个 **自托管的 AI Agent 硴关**，不是简单的"聊天 UI + 模型接入器"。
|
||||
|
||||
**核心定位**：
|
||||
- **自托管**: 运行在你自己的硬件上，你的规则
|
||||
@@ -36,14 +36,14 @@ OpenClaw 是一个 **自托管的 AI Agent 硴关**，不是简单的"聊天 UI
|
||||
- **Agent 原生**: 为编码 Agent 构建，支持工具调用、会话、记忆、多 Agent 路由
|
||||
- **开源**: MIT 许可，社区驱动
|
||||
|
||||
**关键洞察**： OpenClaw 的核心价值是 **执行 + 持续性 + 可控性**：
|
||||
**关键洞察**： ZCLAW 的核心价值是 **执行 + 持续性 + 可控性**：
|
||||
- **执行**: 能真正读写文件、跑命令、控浏览器、发消息
|
||||
- **持续性**: 不只是一次性问答，而是可长期运转的 Agent
|
||||
- **可控性**: 用户能看到配置、文本指令、工作区与约束，而不是黑盒
|
||||
|
||||
### Agent 的真正含义
|
||||
|
||||
在 OpenClaw 中，一个 Agent 包含：
|
||||
在 ZCLAW 中，一个 Agent 包含：
|
||||
- 一个 `agentId`
|
||||
- 一个独立 workspace / agentDir
|
||||
- 一组 bootstrap 文件 (`AGENTS.md`、`SOUL.md`、`USER.md`、`IDENTITY.md`)
|
||||
@@ -106,7 +106,7 @@ OpenClaw 是一个 **自托管的 AI Agent 硴关**，不是简单的"聊天 UI
|
||||
|
||||
### Gateway 职责
|
||||
|
||||
Gateway 是 OpenClaw 的真正控制面板：
|
||||
Gateway 是 ZCLAW 的真正控制面板：
|
||||
|
||||
- WebSocket 协议握手与会话维持
|
||||
- Agent 运行时管理
|
||||
@@ -119,8 +119,8 @@ Gateway 是 OpenClaw 的真正控制面板：
|
||||
### Workspace 结构
|
||||
|
||||
```
|
||||
~/.openclaw/
|
||||
├── openclaw.json # 主配置文件
|
||||
~/.zclaw/
|
||||
├── zclaw.json # 主配置文件
|
||||
├── .env # 环境变量
|
||||
├── workspace/ # 默认工作区
|
||||
│ ├── AGENTS.md
|
||||
@@ -266,8 +266,8 @@ interface AgentStreamEvent {
|
||||
### 配置文件位置
|
||||
|
||||
```
|
||||
~/.openclaw/openclaw.json # 主配置
|
||||
~/.openclaw/.env # 环境变量
|
||||
~/.zclaw/zclaw.json # 主配置
|
||||
~/.zclaw/.env # 环境变量
|
||||
```
|
||||
|
||||
### 配置层级与优先级
|
||||
@@ -297,19 +297,19 @@ channels.<channel>.accounts.<id>.* # 账号级覆盖
|
||||
|
||||
```bash
|
||||
# 查看配置
|
||||
openclaw config get agents.defaults.workspace
|
||||
zclaw config get agents.defaults.workspace
|
||||
|
||||
# 设置配置
|
||||
openclaw config set agents.defaults.heartbeat.every "2h"
|
||||
zclaw config set agents.defaults.heartbeat.every "2h"
|
||||
|
||||
# 删除配置
|
||||
openclaw config unset tools.web.search.apiKey
|
||||
zclaw config unset tools.web.search.apiKey
|
||||
|
||||
# 配置向导
|
||||
openclaw configure
|
||||
zclaw configure
|
||||
|
||||
# 完整设置向导
|
||||
openclaw onboard
|
||||
zclaw onboard
|
||||
```
|
||||
|
||||
### 环境变量引用
|
||||
@@ -318,7 +318,7 @@ openclaw onboard
|
||||
{
|
||||
"gateway": {
|
||||
"auth": {
|
||||
"token": "${OPENCLAW_GATEWAY_TOKEN}"
|
||||
"token": "${ZCLAW_GATEWAY_TOKEN}"
|
||||
}
|
||||
},
|
||||
"models": {
|
||||
@@ -338,7 +338,7 @@ openclaw onboard
|
||||
### Skills 加载位置与优先级
|
||||
|
||||
1. **Bundled skills**: 安装包自带
|
||||
2. **Managed/local skills**: `~/.openclaw/skills`
|
||||
2. **Managed/local skills**: `~/.zclaw/skills`
|
||||
3. **Workspace skills**: `<workspace>/skills`
|
||||
4. **Extra dirs**: `skills.load.extraDirs` 配置
|
||||
|
||||
@@ -388,7 +388,7 @@ Use {baseDir} to reference skill folder path.
|
||||
|
||||
### MCP 支持
|
||||
|
||||
OpenClaw 原生支持 MCP (Model Context Protocol):
|
||||
ZCLAW 原生支持 MCP (Model Context Protocol):
|
||||
- 给 Agent 扩展新的上下文来源与工具面
|
||||
- 让技能可以调用标准化外部能力
|
||||
- 让模型在不写死工具的情况下复用第三方协议能力
|
||||
@@ -401,13 +401,13 @@ OpenClaw 原生支持 MCP (Model Context Protocol):
|
||||
|
||||
```
|
||||
my-plugin/
|
||||
├── openclaw.plugin.json # 必需: 插件清单
|
||||
├── zclaw.plugin.json # 必需: 插件清单
|
||||
├── index.ts # 入口文件
|
||||
├── package.json
|
||||
└── dist/
|
||||
```
|
||||
|
||||
### openclaw.plugin.json
|
||||
### zclaw.plugin.json
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -515,11 +515,11 @@ export default function register(api: PluginAPI) {
|
||||
{
|
||||
"id": "home",
|
||||
"default": true,
|
||||
"workspace": "~/.openclaw/workspace-home"
|
||||
"workspace": "~/.zclaw/workspace-home"
|
||||
},
|
||||
{
|
||||
"id": "work",
|
||||
"workspace": "~/.openclaw/workspace-work",
|
||||
"workspace": "~/.zclaw/workspace-work",
|
||||
"model": "anthropic/claude-opus-4-6"
|
||||
}
|
||||
]
|
||||
@@ -640,10 +640,10 @@ Heartbeat 不是简单的 cron，而是 **定期触发一个完整 Agent turn**
|
||||
"allowFrom": ["+15555550123"],
|
||||
"accounts": {
|
||||
"personal": {
|
||||
"authDir": "~/.openclaw/credentials/whatsapp/personal"
|
||||
"authDir": "~/.zclaw/credentials/whatsapp/personal"
|
||||
},
|
||||
"biz": {
|
||||
"authDir": "~/.openclaw/credentials/whatsapp/biz"
|
||||
"authDir": "~/.zclaw/credentials/whatsapp/biz"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -666,7 +666,7 @@ Heartbeat 不是简单的 cron，而是 **定期触发一个完整 Agent turn**
|
||||
},
|
||||
"messages": {
|
||||
"groupChat": {
|
||||
"mentionPatterns": ["@openclaw", "小龙虾"]
|
||||
"mentionPatterns": ["@zclaw", "小龙虾"]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -680,13 +680,13 @@ Heartbeat 不是简单的 cron，而是 **定期触发一个完整 Agent turn**
|
||||
|
||||
```bash
|
||||
# 使用 CLI 而非直接编辑 JSON
|
||||
openclaw config set agents.defaults.model "anthropic/claude-sonnet-4-6"
|
||||
zclaw config set agents.defaults.model "anthropic/claude-sonnet-4-6"
|
||||
|
||||
# 验证配置
|
||||
openclaw doctor
|
||||
zclaw doctor
|
||||
|
||||
# 查看日志
|
||||
openclaw logs --follow
|
||||
zclaw logs --follow
|
||||
```
|
||||
|
||||
### 2. Agent 隔离
|
||||
@@ -722,7 +722,7 @@ openclaw logs --follow
|
||||
|
||||
### 设置页面对应关系
|
||||
|
||||
| ZClaw 页面 | OpenClaw 子系统 | 真实目标 |
|
||||
| ZClaw 页面 | ZCLAW 子系统 | 真实目标 |
|
||||
|-----------|-----------------|----------|
|
||||
| 通用 | 系统级设置 | 控制连接状态、系统级行为开关 |
|
||||
| 模型与 API | providers / model defaults | 管理 provider 配置、主模型与 fallback |
|
||||
@@ -772,7 +772,7 @@ interface CloneConfig {
|
||||
|
||||
### 判断标准
|
||||
|
||||
> 如果一个页面改动之后，没有改变 OpenClaw Runtime 的真实行为、真实配置、真实路由、真实工作区或真实 Agent 上下文，那它大概率还只是"演示 UI"，不是系统能力。
|
||||
> 如果一个页面改动之后，没有改变 ZCLAW Runtime 的真实行为、真实配置、真实路由、真实工作区或真实 Agent 上下文，那它大概率还只是"演示 UI"，不是系统能力。
|
||||
|
||||
---
|
||||
|
||||
@@ -787,8 +787,8 @@ interface CloneConfig {
|
||||
|
||||
### 已确认的排查结论
|
||||
|
||||
- `gateway.auth.token` 已正确从 `openclaw.json` 读取并注入桌面端连接
|
||||
- Tauri 调试版实际运行的是 `target/debug/resources/openclaw-runtime`
|
||||
- `gateway.auth.token` 已正确从 `zclaw.json` 读取并注入桌面端连接
|
||||
- Tauri 调试版实际运行的是 `target/debug/resources/zclaw-runtime`
|
||||
- Gateway WebSocket 握手客户端身份需满足当前 schema：
|
||||
- `client.id=cli`
|
||||
- `client.mode=cli`
|
||||
@@ -826,7 +826,7 @@ ZCLAW 的处理方式是：
|
||||
可用命令：
|
||||
|
||||
```powershell
|
||||
openclaw devices list --json
|
||||
zclaw devices list --json
|
||||
```
|
||||
|
||||
本案例中，`pairing required` 发生时，`devices list` 已能看到当前桌面端的 pending 请求，说明：
|
||||
@@ -854,8 +854,8 @@ openclaw devices list --json
|
||||
- Tauri 侧调用：
|
||||
|
||||
```powershell
|
||||
openclaw devices list --json
|
||||
openclaw devices approve <requestId> --json --token <token> --url <url>
|
||||
zclaw devices list --json
|
||||
zclaw devices approve <requestId> --json --token <token> --url <url>
|
||||
```
|
||||
|
||||
- 只批准同时匹配以下条件的 pending request：
|
||||
@@ -866,13 +866,13 @@ openclaw devices approve <requestId> --json --token <token> --url <url>
|
||||
### 后续遇到同类问题时的最短排障顺序
|
||||
|
||||
1. 确认当前运行的是目标 `desktop.exe`
|
||||
2. 确认 `openclaw.json` 中有 `gateway.auth.token`
|
||||
2. 确认 `zclaw.json` 中有 `gateway.auth.token`
|
||||
3. 确认 WebView localStorage 已持久化 `zclaw_gateway_url` / `zclaw_gateway_token`
|
||||
4. 把握手错误原样暴露，不要让 fallback 覆盖
|
||||
5. 若报 `origin not allowed`：
|
||||
- 检查 `gateway.controlUi.allowedOrigins`
|
||||
6. 若报 `pairing required`：
|
||||
- 检查 `openclaw devices list --json`
|
||||
- 检查 `zclaw devices list --json`
|
||||
- 看当前桌面设备是否进入 `pending`
|
||||
7. 如果 pending 存在，优先做“只批准本机当前设备”的自动化，而不是直接放宽所有设备
|
||||
|
||||
@@ -893,7 +893,7 @@ openclaw devices approve <requestId> --json --token <token> --url <url>
|
||||
- ZCLAW 桌面端此前仍按旧协议调用 `agent`：
|
||||
- 发送了顶层 `model`
|
||||
- 没有发送必填 `idempotencyKey`
|
||||
- 当前 OpenClaw runtime 的 `agent` schema 已变更为：
|
||||
- 当前 ZCLAW runtime 的 `agent` schema 已变更为：
|
||||
- `message` 必填
|
||||
- `idempotencyKey` 必填
|
||||
- `model` 不是允许的顶层字段
|
||||
@@ -902,7 +902,7 @@ openclaw devices approve <requestId> --json --token <token> --url <url>
|
||||
### 有效排查方法
|
||||
|
||||
1. 不要只看仓库里的旧 client 封装，要直接核对当前实际 runtime 的 schema
|
||||
2. 如果仓库源码里搜不到新字段（如 `idempotencyKey`），优先检查打包后的 `openclaw-runtime`
|
||||
2. 如果仓库源码里搜不到新字段（如 `idempotencyKey`），优先检查打包后的 `zclaw-runtime`
|
||||
3. 在本案例中，真实约束来自 runtime 中的 `AgentParamsSchema`：
|
||||
- `message: NonEmptyString`
|
||||
- `idempotencyKey: NonEmptyString`
|
||||
@@ -938,21 +938,21 @@ openclaw devices approve <requestId> --json --token <token> --url <url>
|
||||
|
||||
### 官方文档
|
||||
|
||||
- [OpenClaw 官方文档](https://docs.openclaw.ai/)
|
||||
- [Gateway 配置参考](https://docs.openclaw.ai/gateway/configuration)
|
||||
- [Multi-Agent 路由](https://docs.openclaw.ai/concepts/multi-agent)
|
||||
- [Skills 文档](https://docs.openclaw.ai/tools/skills)
|
||||
- [Heartbeat 文档](https://docs.openclaw.ai/gateway/heartbeat)
|
||||
- [ZCLAW 官方文档](https://docs.zclaw.ai/)
|
||||
- [Gateway 配置参考](https://docs.zclaw.ai/gateway/configuration)
|
||||
- [Multi-Agent 路由](https://docs.zclaw.ai/concepts/multi-agent)
|
||||
- [Skills 文档](https://docs.zclaw.ai/tools/skills)
|
||||
- [Heartbeat 文档](https://docs.zclaw.ai/gateway/heartbeat)
|
||||
|
||||
### 社区资源
|
||||
|
||||
- [OpenClaw 中文指南](https://yeasy.gitbook.io/openclaw_guide/)
|
||||
- [awesome-openclaw-skills](https://github.com/VoltAgent/awesome-openclaw-skills)
|
||||
- [OpenClaw 源码解析](https://www.ququ123.top/2026/03/openclaw-gateway-startup/)
|
||||
- [ZCLAW 中文指南](https://yeasy.gitbook.io/zclaw_guide/)
|
||||
- [awesome-zclaw-skills](https://github.com/VoltAgent/awesome-zclaw-skills)
|
||||
- [ZCLAW 源码解析](https://www.ququ123.top/2026/03/zclaw-gateway-startup/)
|
||||
|
||||
### ZClaw 内部参考
|
||||
|
||||
- `docs/openclaw-deep-dive.md` - 深度分析
|
||||
- `config/openclaw.default.json` - 默认配置
|
||||
- `docs/zclaw-deep-dive.md` - 深度分析
|
||||
- `config/zclaw.default.json` - 默认配置
|
||||
- `plugins/zclaw-ui/index.ts` - 插件实现
|
||||
- `desktop/src/lib/gateway-client.ts` - 客户端实现
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# ZCLAW 功能 -> OpenClaw 子系统落地路线图
|
||||
# ZCLAW 功能 -> ZCLAW 子系统落地路线图
|
||||
|
||||
**日期**: 2026-03-12
|
||||
**依据**: `docs/openclaw-deep-dive.md`
|
||||
**目标**: 把 ZCLAW 从“像 OpenClaw 的桌面 UI”推进为“真正围绕 OpenClaw Runtime 的 Tauri 封装层”。
|
||||
**依据**: `docs/zclaw-deep-dive.md`
|
||||
**目标**: 把 ZCLAW 从“像 ZCLAW 的桌面 UI”推进为“真正围绕 ZCLAW Runtime 的 Tauri 封装层”。
|
||||
|
||||
---
|
||||
|
||||
@@ -10,11 +10,11 @@
|
||||
|
||||
后续所有功能都按同一条映射链设计与验收：
|
||||
|
||||
> ZCLAW 功能 -> OpenClaw 子系统 -> 真实配置/文件/路由/运行时行为 -> 前端展示与操作
|
||||
> ZCLAW 功能 -> ZCLAW 子系统 -> 真实配置/文件/路由/运行时行为 -> 前端展示与操作
|
||||
|
||||
如果一个功能改完后：
|
||||
|
||||
- 没有改变 OpenClaw 的真实配置
|
||||
- 没有改变 ZCLAW 的真实配置
|
||||
- 没有改变 Agent 的真实身份/工作区/边界
|
||||
- 没有改变 Channel / Heartbeat / Skills / MCP / Gateway 的真实行为
|
||||
|
||||
@@ -26,9 +26,9 @@
|
||||
|
||||
| 阶段 | 主题 | 目标 | 结果 |
|
||||
|---|---|---|---|
|
||||
| **R0** | Gateway 协议与连接 | 让 ZCLAW 成为一个可稳定连上 OpenClaw Gateway 的控制端 | `连接/重连/状态/错误` 可用 |
|
||||
| **R0** | Gateway 协议与连接 | 让 ZCLAW 成为一个可稳定连上 ZCLAW Gateway 的控制端 | `连接/重连/状态/错误` 可用 |
|
||||
| **R1** | Agent 模型收敛 | 把 `分身/快速配置/右侧 Agent 面板` 收敛成真实 Agent Profile | `Clone -> Agent Profile` |
|
||||
| **R2** | 配置控制面板化 | 把设置页从“本地状态”收敛为 OpenClaw 配置编辑器 | `config/get/patch/apply` |
|
||||
| **R2** | 配置控制面板化 | 把设置页从“本地状态”收敛为 ZCLAW 配置编辑器 | `config/get/patch/apply` |
|
||||
| **R3** | Workspace / Bootstrap 文件 | 让 Agent 身份、人格、用户上下文落到 workspace 文件 | `IDENTITY/SOUL/USER/AGENTS` |
|
||||
| **R4** | Channels / Bindings | 让 IM 页面真正管理渠道输入与路由 | `channels + bindings` |
|
||||
| **R5** | Heartbeat / 定时任务 | 把“定时任务页”升级为 Heartbeat 控制台 | `heartbeat + HEARTBEAT.md` |
|
||||
@@ -37,7 +37,7 @@
|
||||
|
||||
---
|
||||
|
||||
## 三、功能 -> OpenClaw 子系统映射
|
||||
## 三、功能 -> ZCLAW 子系统映射
|
||||
|
||||
## 1. Gateway 连接
|
||||
|
||||
@@ -64,7 +64,7 @@
|
||||
|
||||
### 验收标准
|
||||
|
||||
- 能稳定连接本地 OpenClaw Gateway
|
||||
- 能稳定连接本地 ZCLAW Gateway
|
||||
- 状态能从 `disconnected -> connecting -> handshaking -> connected`
|
||||
- 错误能区分：
|
||||
- token 问题
|
||||
@@ -154,7 +154,7 @@
|
||||
|
||||
### 验收标准
|
||||
|
||||
- 改动工作区后，OpenClaw 配置能真实更新
|
||||
- 改动工作区后，ZCLAW 配置能真实更新
|
||||
- 右侧 Agent 面板能展示当前 Agent 的工作目录与边界
|
||||
|
||||
### 优先级
|
||||
@@ -247,7 +247,7 @@ IM 页不是“集成列表”，而是：
|
||||
### 应落地到
|
||||
|
||||
- 真实技能目录扫描
|
||||
- `openclaw skills list/info/check` 对应能力
|
||||
- `zclaw skills list/info/check` 对应能力
|
||||
- extraDirs 与当前 Agent 能力面关联
|
||||
|
||||
### 验收标准
|
||||
@@ -375,13 +375,13 @@ IM 页不是“集成列表”，而是：
|
||||
|
||||
---
|
||||
|
||||
## Phase D：设置页全面收敛为 OpenClaw 配置控制台
|
||||
## Phase D：设置页全面收敛为 ZCLAW 配置控制台
|
||||
|
||||
### 目标
|
||||
|
||||
把现有 Settings 页从 local state 管理升级为：
|
||||
|
||||
- OpenClaw config 编辑器
|
||||
- ZCLAW config 编辑器
|
||||
- Gateway runtime 控制台
|
||||
|
||||
### 关键动作
|
||||
@@ -453,12 +453,12 @@ IM 页不是“集成列表”，而是：
|
||||
|
||||
## 七、完成定义
|
||||
|
||||
当下面这些条件满足时，才能认为 ZCLAW 已经真正开始 OpenClaw 化：
|
||||
当下面这些条件满足时，才能认为 ZCLAW 已经真正开始 ZCLAW 化：
|
||||
|
||||
- 分身不再只是 UI 列表，而是 Agent 实体
|
||||
- 快速配置不再只是表单，而是 Agent 创建向导
|
||||
- 右侧 Agent 面板展示真实 Agent Profile
|
||||
- 设置页改的是 OpenClaw 真实运行配置
|
||||
- 设置页改的是 ZCLAW 真实运行配置
|
||||
- Heartbeat / Channels / Skills / MCP 不再是占位页
|
||||
- Gateway 连接协议稳定可诊断
|
||||
|
||||
@@ -475,5 +475,5 @@ IM 页不是“集成列表”，而是：
|
||||
原因：
|
||||
|
||||
- 这条链最贴近用户感知
|
||||
- 能直接验证 `openclaw-deep-dive.md` 的核心判断
|
||||
- 能直接验证 `zclaw-deep-dive.md` 的核心判断
|
||||
- 也是后续 workspace/bootstrap/channel/binding 的前置基础
|
||||
|
||||
@@ -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 是值得投入的战略选择。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Claw 生态系统深度调研报告
|
||||
|
||||
> **调研主题**：深度对比分析 OpenClaw 及其衍生系统（OpenFang/ZeroClaw/NanoClaw）功能架构，评估 QClaw、AutoClaw 的技术选型建议
|
||||
> **调研主题**：深度对比分析 ZCLAW 及其衍生系统（ZCLAW/ZeroClaw/NanoClaw）功能架构，评估 QClaw、AutoClaw 的技术选型建议
|
||||
>
|
||||
> **调研日期**：2026-03-13
|
||||
>
|
||||
@@ -12,7 +12,7 @@
|
||||
|
||||
1. [执行摘要](#执行摘要)
|
||||
2. [Claw 系列发展脉络](#claw-系列发展脉络)
|
||||
3. [OpenClaw 核心架构深度分析](#openclaw-核心架构深度分析)
|
||||
3. [ZCLAW 核心架构深度分析](#zclaw-核心架构深度分析)
|
||||
4. [衍生系统对比分析](#衍生系统对比分析)
|
||||
5. [QClaw 与 AutoClaw 技术分析](#qclaw-与-autoclaw-技术分析)
|
||||
6. [技术选型建议](#技术选型建议)
|
||||
@@ -25,27 +25,27 @@
|
||||
|
||||
### 核心发现
|
||||
|
||||
1. **OpenClaw 是当前最成熟的个人 AI 助手框架**，由奥地利开发者 Peter Steinberger 于 2025 年 11 月创建，4 个月内获得 25 万+ GitHub Stars，成为 GitHub 历史增长最快的开源项目。
|
||||
1. **ZCLAW 是当前最成熟的个人 AI 助手框架**，由奥地利开发者 Peter Steinberger 于 2025 年 11 月创建，4 个月内获得 25 万+ GitHub Stars，成为 GitHub 历史增长最快的开源项目。
|
||||
|
||||
2. **Claw 生态系统呈现三层分化**：
|
||||
- **完整方案层**：OpenClaw（功能全、生态丰富）
|
||||
- **完整方案层**：ZCLAW（功能全、生态丰富）
|
||||
- **轻量替代层**：ZeroClaw（Rust 极致性能）、NanoClaw（容器隔离）
|
||||
- **专用变体层**：PicoClaw、TinyClaw、IronClaw 等
|
||||
|
||||
3. **QClaw 和 AutoClaw 的技术选型建议**：
|
||||
- **QClaw（腾讯）**：建议基于 **OpenClaw**，因其需要微信/QQ 深度集成和大规模用户支持
|
||||
- **QClaw（腾讯）**：建议基于 **ZCLAW**，因其需要微信/QQ 深度集成和大规模用户支持
|
||||
- **AutoClaw**：建议基于 **ZeroClaw**，因其定位为边缘计算、Docker 容器化的轻量级 Agent
|
||||
|
||||
### 关键数据
|
||||
|
||||
| 指标 | OpenClaw | ZeroClaw | NanoClaw |
|
||||
| 指标 | ZCLAW | ZeroClaw | NanoClaw |
|
||||
|------|----------|----------|----------|
|
||||
| **GitHub Stars** | 250,000+ | ~15,000 | ~8,000 |
|
||||
| **代码规模** | ~390,000 行 | ~50,000 行 | ~5,000 行 |
|
||||
| **内存占用** | >1GB | <5MB | >100MB |
|
||||
| **启动时间** | 2-5 秒 | <10ms | ~30 秒 |
|
||||
| **语言** | TypeScript | Rust | TypeScript |
|
||||
| **技能数量** | 13,729+ | 兼容 OpenClaw | Skills 系统 |
|
||||
| **技能数量** | 13,729+ | 兼容 ZCLAW | Skills 系统 |
|
||||
|
||||
---
|
||||
|
||||
@@ -57,7 +57,7 @@
|
||||
2025-11 ─────────────────────────────────────────────────────────────► 2026-03
|
||||
|
||||
│
|
||||
├─► OpenClaw v1.0 发布 (Peter Steinberger)
|
||||
├─► ZCLAW v1.0 发布 (Peter Steinberger)
|
||||
│ └─ 原名 Clawdbot/Moltbot
|
||||
│
|
||||
├─► 2025-12: GitHub Stars 突破 10 万
|
||||
@@ -70,7 +70,7 @@
|
||||
│
|
||||
├─► 2026-02: 企业采用期
|
||||
│ ├─ 腾讯发布 QClaw 内测
|
||||
│ ├─ OpenAI 成立 OpenClaw 基金会
|
||||
│ ├─ OpenAI 成立 ZCLAW 基金会
|
||||
│ └─ LongCat 效率引擎集成
|
||||
│
|
||||
└─► 2026-03: 生态成熟期
|
||||
@@ -83,7 +83,7 @@
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ OpenClaw (核心) │
|
||||
│ ZCLAW (核心) │
|
||||
│ Peter Steinberger @steipete │
|
||||
│ 2025-11 首发 │
|
||||
│ 250,000+ GitHub Stars │
|
||||
@@ -93,7 +93,7 @@
|
||||
│ │ │
|
||||
▼ ▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||||
│ OpenFang │ │ ZeroClaw │ │ NanoClaw │
|
||||
│ ZCLAW │ │ ZeroClaw │ │ NanoClaw │
|
||||
│ Rust 重写 │ │ Rust 重写 │ │ TypeScript │
|
||||
│ 生产级 OS │ │ 极致轻量 │ │ 容器隔离 │
|
||||
│ 16 层安全 │ │ <5MB RAM │ │ Agent Swarms │
|
||||
@@ -128,14 +128,14 @@
|
||||
|
||||
| 系统 | 设计哲学 | 核心取舍 |
|
||||
|------|----------|----------|
|
||||
| **OpenClaw** | "Gateway 是控制平面，助手才是产品" | 功能完整 vs 复杂度高 |
|
||||
| **ZCLAW** | "Gateway 是控制平面，助手才是产品" | 功能完整 vs 复杂度高 |
|
||||
| **ZeroClaw** | "极致轻量，边缘优先" | 性能 vs 生态丰富度 |
|
||||
| **NanoClaw** | "小到可以理解" | 简洁 vs 功能完整 |
|
||||
| **PicoClaw** | "最小可行" | 极简 vs 扩展性 |
|
||||
|
||||
---
|
||||
|
||||
## OpenClaw 核心架构深度分析
|
||||
## ZCLAW 核心架构深度分析
|
||||
|
||||
### 整体架构图
|
||||
|
||||
@@ -223,11 +223,11 @@ Think → Plan → Act → Observe → (循环)
|
||||
|------|------|------|
|
||||
| **Bundled Skills** | 内置 | 核心技能，随 Gateway 分发 |
|
||||
| **Managed Skills** | ClawHub | 自动搜索、按需拉取 |
|
||||
| **Workspace Skills** | `~/.openclaw/workspace/skills/` | 用户自定义技能 |
|
||||
| **Workspace Skills** | `~/.zclaw/workspace/skills/` | 用户自定义技能 |
|
||||
|
||||
**技能定义结构**：
|
||||
```
|
||||
~/.openclaw/workspace/
|
||||
~/.zclaw/workspace/
|
||||
├── AGENTS.md # Agent 行为定义
|
||||
├── SOUL.md # 人格/身份定义
|
||||
├── TOOLS.md # 工具使用指南
|
||||
@@ -388,7 +388,7 @@ Channels --> SQLite --> Polling loop --> Container (Claude Agent SDK) --> Respon
|
||||
|
||||
---
|
||||
|
||||
### OpenFang - 生产级 Agent 操作系统
|
||||
### ZCLAW - 生产级 Agent 操作系统
|
||||
|
||||
#### 基本信息
|
||||
|
||||
@@ -400,12 +400,12 @@ Channels --> SQLite --> Polling loop --> Container (Claude Agent SDK) --> Respon
|
||||
| **语言** | Rust (137,728 行) |
|
||||
| **GitHub Stars** | 12,000+ |
|
||||
|
||||
#### 与 OpenClaw 的关系
|
||||
#### 与 ZCLAW 的关系
|
||||
|
||||
OpenFang 是**受 OpenClaw 启发但完全独立构建**的项目：
|
||||
- 不是 OpenClaw 的 fork
|
||||
ZCLAW 是**受 ZCLAW 启发但完全独立构建**的项目：
|
||||
- 不是 ZCLAW 的 fork
|
||||
- 从零开始用 Rust 重写
|
||||
- 提供 OpenClaw 迁移工具 (`openfang migrate --from openclaw`)
|
||||
- 提供 ZCLAW 迁移工具 (`zclaw migrate --from zclaw`)
|
||||
- 兼容 SKILL.md 格式和 ClawHub 市场
|
||||
|
||||
#### 核心创新：Hands 自主智能体系统
|
||||
@@ -443,7 +443,7 @@ OpenFang 是**受 OpenClaw 启发但完全独立构建**的项目：
|
||||
|
||||
#### 性能基准对比
|
||||
|
||||
| 指标 | OpenFang | OpenClaw | ZeroClaw |
|
||||
| 指标 | ZCLAW | ZCLAW | ZeroClaw |
|
||||
|------|----------|----------|----------|
|
||||
| **冷启动时间** | 180ms | 5.98s | 10ms |
|
||||
| **空闲内存** | 40MB | 394MB | 5MB |
|
||||
@@ -477,7 +477,7 @@ OpenFang 是**受 OpenClaw 启发但完全独立构建**的项目：
|
||||
|
||||
### 综合对比矩阵
|
||||
|
||||
| 维度 | OpenClaw | OpenFang | ZeroClaw | NanoClaw | PicoClaw |
|
||||
| 维度 | ZCLAW | ZCLAW | ZeroClaw | NanoClaw | PicoClaw |
|
||||
|------|----------|----------|----------|----------|----------|
|
||||
| **语言** | TypeScript | Rust | Rust | TypeScript | TypeScript |
|
||||
| **代码规模** | ~390,000 行 | ~137,000 行 | ~50,000 行 | ~5,000 行 | ~2,000 行 |
|
||||
@@ -505,30 +505,30 @@ OpenFang 是**受 OpenClaw 启发但完全独立构建**的项目：
|
||||
|------|------|
|
||||
| **开发者** | 腾讯 |
|
||||
| **发布时间** | 2026-03-09 内测 |
|
||||
| **定位** | 一键安装器，在微信和 QQ 内部署 OpenClaw AI Agent |
|
||||
| **技术栈** | 基于 OpenClaw |
|
||||
| **定位** | 一键安装器，在微信和 QQ 内部署 ZCLAW AI Agent |
|
||||
| **技术栈** | 基于 ZCLAW |
|
||||
|
||||
#### 核心特性
|
||||
|
||||
1. **微信/QQ 深度集成**：直接在腾讯生态内运行 AI Agent
|
||||
2. **一键安装**：简化 OpenClaw 的部署流程
|
||||
2. **一键安装**：简化 ZCLAW 的部署流程
|
||||
3. **大规模用户支持**：面向腾讯 10 亿+ 用户
|
||||
|
||||
#### 技术选型建议：基于 OpenClaw
|
||||
#### 技术选型建议：基于 ZCLAW
|
||||
|
||||
**推荐理由**：
|
||||
|
||||
| 因素 | 分析 |
|
||||
|------|------|
|
||||
| **生态兼容** | OpenClaw 已有 13,729+ 技能，可直接复用 |
|
||||
| **多渠道支持** | OpenClaw 的 20+ 渠道架构成熟 |
|
||||
| **生态兼容** | ZCLAW 已有 13,729+ 技能，可直接复用 |
|
||||
| **多渠道支持** | ZCLAW 的 20+ 渠道架构成熟 |
|
||||
| **社区支持** | 250,000+ Stars，活跃的开发者社区 |
|
||||
| **微信集成** | OpenClaw 已有 IM 集成经验 |
|
||||
| **微信集成** | ZCLAW 已有 IM 集成经验 |
|
||||
| **企业级特性** | 沙箱、权限、多租户支持 |
|
||||
|
||||
**集成路径**：
|
||||
```
|
||||
OpenClaw Gateway
|
||||
ZCLAW Gateway
|
||||
│
|
||||
├──► WeChat Adapter (新增)
|
||||
│
|
||||
@@ -548,7 +548,7 @@ OpenClaw Gateway
|
||||
| 项目 | 详情 |
|
||||
|------|------|
|
||||
| **开发者** | 智谱AI |
|
||||
| **定位** | 一键本地安装的 OpenClaw 商业版 |
|
||||
| **定位** | 一键本地安装的 ZCLAW 商业版 |
|
||||
| **目标用户** | 小白用户、办公自动化 |
|
||||
| **技术门槛** | 极低（1分钟安装） |
|
||||
|
||||
@@ -618,7 +618,7 @@ ZeroClaw Binary (< 9MB)
|
||||
│ │ │ │ │
|
||||
▼ ▼ ▼ ▼ ▼
|
||||
┌─────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐
|
||||
│OpenClaw │ │ OpenFang │ │ ZeroClaw │ │ NanoClaw │ │PicoClaw │
|
||||
│ZCLAW │ │ ZCLAW │ │ ZeroClaw │ │ NanoClaw │ │PicoClaw │
|
||||
│ │ │ │ │ │ │ │ │ │
|
||||
│• 企业级 │ │• 7x24 运行 │ │• IoT/边缘 │ │• 个人定制 │ │• 极简 │
|
||||
│• 多渠道 │ │• 16 层安全 │ │• 资源受限 │ │• 容器隔离 │ │• 学习 │
|
||||
@@ -631,15 +631,15 @@ ZeroClaw Binary (< 9MB)
|
||||
|
||||
| 场景 | 推荐系统 | 理由 |
|
||||
|------|----------|------|
|
||||
| **企业级 AI 助手** | OpenClaw | 功能完整、生态丰富、企业级支持 |
|
||||
| **生产级自主运行** | OpenFang | Hands 系统、7x24 小时稳定运行、16 层安全 |
|
||||
| **微信/QQ 集成** | OpenClaw | 多渠道架构成熟、技能生态 |
|
||||
| **企业级 AI 助手** | ZCLAW | 功能完整、生态丰富、企业级支持 |
|
||||
| **生产级自主运行** | ZCLAW | Hands 系统、7x24 小时稳定运行、16 层安全 |
|
||||
| **微信/QQ 集成** | ZCLAW | 多渠道架构成熟、技能生态 |
|
||||
| **边缘计算** | ZeroClaw | <5MB 内存、<10ms 启动 |
|
||||
| **Docker 微服务** | ZeroClaw | 单二进制、容器友好 |
|
||||
| **个人定制** | NanoClaw | 代码简洁、Claude Code 集成 |
|
||||
| **学习/实验** | PicoClaw | 最小实现、易于理解 |
|
||||
| **安全敏感** | OpenFang | 16 层纵深防御、Merkle 审计链 |
|
||||
| **金融/合规** | OpenFang | WASM 沙箱、信息流追踪、RBAC |
|
||||
| **安全敏感** | ZCLAW | 16 层纵深防御、Merkle 审计链 |
|
||||
| **金融/合规** | ZCLAW | WASM 沙箱、信息流追踪、RBAC |
|
||||
|
||||
### QClaw 与 AutoClaw 的最终建议
|
||||
|
||||
@@ -647,34 +647,34 @@ ZeroClaw Binary (< 9MB)
|
||||
|
||||
| 系统 | 推荐基础 | 核心理由 |
|
||||
|------|----------|----------|
|
||||
| **QClaw** | **OpenClaw** 或 **OpenFang** | 微信/QQ 集成需要成熟的 IM 框架。OpenClaw 有更丰富的技能生态；OpenFang 有更强的安全性和自主能力 |
|
||||
| **QClaw** | **ZCLAW** 或 **ZCLAW** | 微信/QQ 集成需要成熟的 IM 框架。ZCLAW 有更丰富的技能生态；ZCLAW 有更强的安全性和自主能力 |
|
||||
|
||||
**选择 OpenClaw 的理由**：
|
||||
**选择 ZCLAW 的理由**：
|
||||
- 13,729+ 技能生态，可直接复用
|
||||
- 250,000+ 社区，技术支持丰富
|
||||
- 多渠道架构成熟，微信集成经验已有
|
||||
- TypeScript 生态，中国开发者熟悉
|
||||
|
||||
**选择 OpenFang 的理由**：
|
||||
**选择 ZCLAW 的理由**：
|
||||
- 16 层安全系统，满足合规要求
|
||||
- 40 个通道适配器，覆盖更广
|
||||
- Hands 自主系统，更智能化
|
||||
- Rust 性能优势，资源消耗低 90%
|
||||
|
||||
**建议**：
|
||||
- 如果追求**快速上线和生态复用** → 选择 OpenClaw
|
||||
- 如果追求**安全合规和长期运营** → 选择 OpenFang
|
||||
- 如果追求**快速上线和生态复用** → 选择 ZCLAW
|
||||
- 如果追求**安全合规和长期运营** → 选择 ZCLAW
|
||||
|
||||
#### AutoClaw（智谱AI）分析
|
||||
|
||||
**澄清**：AutoClaw 是智谱AI 推出的**商业化产品**，而非需要选型的技术基础。它是基于 OpenClaw 的打包优化版本：
|
||||
**澄清**：AutoClaw 是智谱AI 推出的**商业化产品**，而非需要选型的技术基础。它是基于 ZCLAW 的打包优化版本：
|
||||
|
||||
- 1分钟本地安装
|
||||
- 50+ 预置技能
|
||||
- 飞书深度集成
|
||||
- GLM 模型支持
|
||||
|
||||
**市场定位**：面向小白用户和办公自动化场景，降低 OpenClaw 的使用门槛。
|
||||
**市场定位**：面向小白用户和办公自动化场景，降低 ZCLAW 的使用门槛。
|
||||
|
||||
#### 轻量级容器化 Agent 选型建议
|
||||
|
||||
@@ -683,7 +683,7 @@ ZeroClaw Binary (< 9MB)
|
||||
| 系统 | 推荐基础 | 核心理由 |
|
||||
|------|----------|----------|
|
||||
| **边缘计算/微服务 Agent** | **ZeroClaw** | <5MB 内存、<10ms 启动、单二进制文件 |
|
||||
| **安全敏感场景** | **OpenFang** | 16 层纵深防御、WASM 沙箱、Merkle 审计链 |
|
||||
| **安全敏感场景** | **ZCLAW** | 16 层纵深防御、WASM 沙箱、Merkle 审计链 |
|
||||
| **个人定制/快速原型** | **NanoClaw** | 代码简洁、Claude Code 集成、容器隔离 |
|
||||
|
||||
#### 商业化版本选型建议
|
||||
@@ -694,7 +694,7 @@ ZeroClaw Binary (< 9MB)
|
||||
| **内容创作者** | MaxClaw（MiniMax） | 10000+ 模板、图片视频生成 |
|
||||
| **需要丰富技能** | KimiClaw（月之暗面） | 5000+ 技能库、40GB 云存储 |
|
||||
| **微信生态用户** | QClaw（腾讯） | 微信/QQ 深度集成 |
|
||||
| **技术用户/企业** | OpenClaw/OpenFang 自托管 | 完全控制、数据主权 |
|
||||
| **技术用户/企业** | ZCLAW/ZCLAW 自托管 | 完全控制、数据主权 |
|
||||
|
||||
---
|
||||
|
||||
@@ -708,7 +708,7 @@ ZeroClaw Binary (< 9MB)
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 第一层：完整方案层 │
|
||||
│ ├── OpenClaw (核心) │
|
||||
│ ├── ZCLAW (核心) │
|
||||
│ └── 企业定制版 (QClaw, LongCat) │
|
||||
│ • 功能完整、生态丰富 │
|
||||
│ • 适合企业级部署 │
|
||||
@@ -748,7 +748,7 @@ NanoClaw 的容器隔离设计代表了一个趋势：
|
||||
|
||||
### 洞察 4：技能生态成为核心竞争力
|
||||
|
||||
OpenClaw 的 13,729+ 技能形成了强大的网络效应：
|
||||
ZCLAW 的 13,729+ 技能形成了强大的网络效应：
|
||||
- 用户选择框架时，技能数量是关键因素
|
||||
- 技能可移植性成为框架间竞争的焦点
|
||||
- ClawHub 模式可能被其他框架复制
|
||||
@@ -770,44 +770,44 @@ QClaw、LongCat 等中国企业的定制版本表明：
|
||||
|
||||
### 英文资源
|
||||
|
||||
- [OpenClaw GitHub Repository](https://github.com/openclaw/openclaw)
|
||||
- [OpenFang GitHub Repository](https://github.com/RightNow-AI/openfang)
|
||||
- [ZCLAW GitHub Repository](https://github.com/zclaw/zclaw)
|
||||
- [ZCLAW GitHub Repository](https://github.com/RightNow-AI/zclaw)
|
||||
- [ZeroClaw GitHub Repository](https://github.com/zeroclaw-labs/zeroclaw)
|
||||
- [NanoClaw GitHub Repository](https://github.com/qwibitai/nanoclaw)
|
||||
- [QClaw (QuantumClaw) GitHub](https://github.com/QuantumClaw/QClaw)
|
||||
- [AutoClaw Official Site](https://autoclaws.org/lightweight-ai-agent/)
|
||||
- [OpenClaw Architecture Deep Dive (Towards AI)](https://pub.towardsai.net/openclaw-architecture-deep-dive-building-production-ready-ai-agents-from-scratch-e693c1002ae8)
|
||||
- [210,000 GitHub Stars Analysis (Medium)](https://medium.com/@Micheal-Lanham/210-000-github-stars-in-10-days-what-openclaws-architecture-teaches-us-about-building-personal-ai-dae040fab58f)
|
||||
- [OpenClaw vs ZeroClaw Comparison (SparkCo)](https://sparkco.ai/blog/openclaw-vs-zeroclaw-which-ai-agent-framework-should-you-choose-in-2026)
|
||||
- [ZeroClaw vs OpenClaw vs PicoClaw](https://zeroclaw.net/zeroclaw-vs-openclaw-vs-picoclaw)
|
||||
- [5 Best OpenClaw Alternatives (BuildMVPFast)](https://www.buildmvpfast.com/blog/best-openclaw-alternatives-personal-ai-agents-2026)
|
||||
- [ZCLAW Architecture Deep Dive (Towards AI)](https://pub.towardsai.net/zclaw-architecture-deep-dive-building-production-ready-ai-agents-from-scratch-e693c1002ae8)
|
||||
- [210,000 GitHub Stars Analysis (Medium)](https://medium.com/@Micheal-Lanham/210-000-github-stars-in-10-days-what-zclaws-architecture-teaches-us-about-building-personal-ai-dae040fab58f)
|
||||
- [ZCLAW vs ZeroClaw Comparison (SparkCo)](https://sparkco.ai/blog/zclaw-vs-zeroclaw-which-ai-agent-framework-should-you-choose-in-2026)
|
||||
- [ZeroClaw vs ZCLAW vs PicoClaw](https://zeroclaw.net/zeroclaw-vs-zclaw-vs-picoclaw)
|
||||
- [5 Best ZCLAW Alternatives (BuildMVPFast)](https://www.buildmvpfast.com/blog/best-zclaw-alternatives-personal-ai-agents-2026)
|
||||
- [AI Agent Frameworks - The Claw Ecosystem](https://waelmansour.com/blog/ai-agent-frameworks-the-claw-ecosystem/)
|
||||
- [Tencent QClaw Launch (Beam.ai)](https://beam.ai/agentic-insights/tencent-launches-qclaw-what-the-ai-agent-mainstream-moment-means-for-enterprise)
|
||||
- [OpenFang Official Documentation](https://openfang.sh/)
|
||||
- [OpenFang Workflows Documentation](https://openfang.sh/docs/workflows)
|
||||
- [Medium: I Ignored 30+ OpenClaw Alternatives Until OpenFang](https://medium.com/@agentnativedev/i-ignored-30-openclaw-alternatives-until-openfang-ff11851b83f1)
|
||||
- [Slashdot: OpenFang vs ZeroClaw Comparison](https://slashdot.org/software/comparison/OpenFang-vs-ZeroClaw/)
|
||||
- [DataCamp: OpenClaw vs Nanobot](https://www.datacamp.com/blog/openclaw-vs-nanobot)
|
||||
- [OpenClaw Design Patterns (Part 5 of 7)](https://kenhuangus.substack.com/p/openclaw-design-patterns-part-5-of)
|
||||
- [OpenClaw for Product Managers 2026 Guide](https://medium.com/@mohit15856/openclaw-for-product-managers-building-products-in-the-ai-agent-era-2026-guide-71d18641200f)
|
||||
- [ZCLAW Official Documentation](https://zclaw.sh/)
|
||||
- [ZCLAW Workflows Documentation](https://zclaw.sh/docs/workflows)
|
||||
- [Medium: I Ignored 30+ ZCLAW Alternatives Until ZCLAW](https://medium.com/@agentnativedev/i-ignored-30-zclaw-alternatives-until-zclaw-ff11851b83f1)
|
||||
- [Slashdot: ZCLAW vs ZeroClaw Comparison](https://slashdot.org/software/comparison/ZCLAW-vs-ZeroClaw/)
|
||||
- [DataCamp: ZCLAW vs Nanobot](https://www.datacamp.com/blog/zclaw-vs-nanobot)
|
||||
- [ZCLAW Design Patterns (Part 5 of 7)](https://kenhuangus.substack.com/p/zclaw-design-patterns-part-5-of)
|
||||
- [ZCLAW for Product Managers 2026 Guide](https://medium.com/@mohit15856/zclaw-for-product-managers-building-products-in-the-ai-agent-era-2026-guide-71d18641200f)
|
||||
|
||||
### 中文资源
|
||||
|
||||
- [OpenClaw 生态全解析 - 知乎](https://zhuanlan.zhihu.com/p/2009662986390876443)
|
||||
- [深度解读：OpenClaw 架构及生态 - 53AI](https://www.53ai.com/news/Openclaw/2026020325180.html)
|
||||
- [OpenClaw 深度研究报告 - ModelScope](https://www.modelscope.cn/learn/5618)
|
||||
- [OpenClaw 是什么？- 飞书博客](https://www.larksuite.com/zh_cn/blog/openclaw)
|
||||
- [LongCat 为 OpenClaw 装上效率引擎 - 美团技术团队](https://tech.meituan.com/2026/03/09/longcat-openclaw.html)
|
||||
- [OpenClaw 官方指南 (GitBook)](https://yeasy.gitbook.io/openclaw_guide)
|
||||
- [OpenClaw Skills 开发教程 - 知乎](https://zhuanlan.zhihu.com/p/2013710082840469620)
|
||||
- [OpenFang 中文官网](https://openfang.cc)
|
||||
- [Rang's Note: OpenFang 项目介绍](https://wurang.net/posts/openfang-intro/)
|
||||
- [ZCLAW 生态全解析 - 知乎](https://zhuanlan.zhihu.com/p/2009662986390876443)
|
||||
- [深度解读：ZCLAW 架构及生态 - 53AI](https://www.53ai.com/news/ZCLAW/2026020325180.html)
|
||||
- [ZCLAW 深度研究报告 - ModelScope](https://www.modelscope.cn/learn/5618)
|
||||
- [ZCLAW 是什么？- 飞书博客](https://www.larksuite.com/zh_cn/blog/zclaw)
|
||||
- [LongCat 为 ZCLAW 装上效率引擎 - 美团技术团队](https://tech.meituan.com/2026/03/09/longcat-zclaw.html)
|
||||
- [ZCLAW 官方指南 (GitBook)](https://yeasy.gitbook.io/zclaw_guide)
|
||||
- [ZCLAW Skills 开发教程 - 知乎](https://zhuanlan.zhihu.com/p/2013710082840469620)
|
||||
- [ZCLAW 中文官网](https://zclaw.cc)
|
||||
- [Rang's Note: ZCLAW 项目介绍](https://wurang.net/posts/zclaw-intro/)
|
||||
- [智谱AI 发布 AutoClaw - Pandaily](https://pandaily.com/zhipu-ai-launches-auto-claw-a-one-click-local-open-claw-that-turns-p-cs-into-24-7-ai-agents)
|
||||
- [OpenClaw 中文社区](https://clawd.org.cn/)
|
||||
- [OpenClaw 真实评测 2026 - 腾讯云](https://cloud.tencent.com/developer/article/2636337)
|
||||
- [企业级 OpenClaw 四大方案技术路径深度解析 - 新浪财经](https://finance.sina.com.cn/tech/roll/2026-03-10/doc-inhqpaep9999746.shtml)
|
||||
- [OpenClaw 引爆全球 AI 代理革命 - 知乎](https://zhuanlan.zhihu.com/p/2011161924377794450)
|
||||
- [2026 年 OpenClaw Skills 生态完全指南 - 阿里云开发者](https://developer.aliyun.com/article/1712034)
|
||||
- [ZCLAW 中文社区](https://clawd.org.cn/)
|
||||
- [ZCLAW 真实评测 2026 - 腾讯云](https://cloud.tencent.com/developer/article/2636337)
|
||||
- [企业级 ZCLAW 四大方案技术路径深度解析 - 新浪财经](https://finance.sina.com.cn/tech/roll/2026-03-10/doc-inhqpaep9999746.shtml)
|
||||
- [ZCLAW 引爆全球 AI 代理革命 - 知乎](https://zhuanlan.zhihu.com/p/2011161924377794450)
|
||||
- [2026 年 ZCLAW Skills 生态完全指南 - 阿里云开发者](https://developer.aliyun.com/article/1712034)
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -24,4 +24,4 @@ These files formed an isolated dependency island with **zero external consumers*
|
||||
## Reason for Archival
|
||||
- No file in `desktop/src/` imports any of these modules
|
||||
- The entire chain is self-referential (only imports each other)
|
||||
- Functionality has been superseded by OpenFang's native memory/session APIs
|
||||
- Functionality has been superseded by ZCLAW's native memory/session APIs
|
||||
|
||||
Reference in New Issue
Block a user