refactor: 统一项目名称从OpenFang到ZCLAW

重构所有代码和文档中的项目名称，将OpenFang统一更新为ZCLAW。包括： - 配置文件中的项目名称 - 代码注释和文档引用 - 环境变量和路径 - 类型定义和接口名称 - 测试用例和模拟数据同时优化部分代码结构，移除未使用的模块，并更新相关依赖项。
2026-03-27 07:36:03 +08:00
parent 4b08804aa9
commit 0d4fa96b82
226 changed files with 7288 additions and 5788 deletions
--- a/docs/archive/openclaw-legacy/README.md
+++ b/docs/archive/openclaw-legacy/README.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 的演进过程。
--- a/docs/archive/openclaw-legacy/deviation-analysis.md
+++ b/docs/archive/openclaw-legacy/deviation-analysis.md
@@ -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 + 技术文章的深度分析*
--- a/docs/archive/openclaw-legacy/openclaw-deep-dive.md
+++ b/docs/archive/openclaw-legacy/openclaw-deep-dive.md
@@ -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 封装层”。
--- a/docs/archive/openclaw-legacy/openclaw-knowledge-base.md
+++ b/docs/archive/openclaw-legacy/openclaw-knowledge-base.md
@@ -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` - 客户端实现
--- a/docs/archive/openclaw-legacy/zclaw-openclaw-roadmap.md
+++ b/docs/archive/openclaw-legacy/zclaw-openclaw-roadmap.md
@@ -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 的前置基础