Claude Code vs OpenClaw 架构对比分析报告

研究任务：深度分析 Claude Code 泄露源码中的可借鉴设计
研究Agent：Agent 4 - 架构对比
日期：2026-04-02

执行摘要

Anthropic 的 Claude Code 于 2026年3月31日意外泄露了 51.2 万行源码，揭示了其内部架构和大量未发布功能。本报告对比 Claude Code 与 OpenClaw 的架构差异，提取可借鉴的设计模式，并给出实施优先级建议。

核心发现：

• Claude Code 采用 三层记忆架构（MEMORY.md索引 → Topic文件 → 原始转录），OpenClaw 采用 文件+向量混合架构
• Claude Code 有 40+ 内置工具，OpenClaw 采用 Skills插件系统 扩展工具
• Claude Code 使用 Ink + Bun 技术栈，OpenClaw 使用 Node.js + Gateway 架构
• Claude Code 隐藏了 KAIROS/ULTRAPLAN 多Agent协调系统，OpenClaw 已实现 subagent 架构

1. Claude Code 核心特性梳理

1.1 BUDDY 终端宠物系统

Claude Code 源码中最令人惊喜的发现是一个完整的 Tamagotchi 风格终端宠物系统。

技术实现：

// buddy/companion.ts
Species (18 total, hidden via String.fromCharCode()):
- duck, dragon, axolotl, capybara, mushroom, ghost, nebulynx...

Rarity tiers:
- Common > Uncommon > Rare > Epic > Legendary
- 1% shiny chance

Stats:
- DEBUGGING / PATIENCE / CHAOS / WISDOM / SNARK

Determined by:
- Mulberry32 PRNG seeded from userId hash + salt 'friend-2026-401'
- 同一用户始终获得相同物种（确定性生成）

设计理念： 在严肃的编程工具中注入人格化元素，增强用户情感连接。

1.2 Undercover Mode（卧底模式）

一个争议性功能，在向开源代码提交 PR 时自动移除所有 Anthropic 相关信息。

// 代码中的提示词明确写到：
"让AI伪装成人类"

争议点： 这可能违反开源社区的透明度原则。

1.3 Dream / KAIROS 记忆系统

四层记忆整合管道：

Layer 1: MEMORY.md
  → 轻量级索引指针（每条约150字符）
  → 始终加载在上下文中
  → 存储位置而非数据

Layer 2: Topic Files
  → 实际项目知识，按需获取
  → 从不同时完整加载

Layer 3: Raw Transcripts
  → 仅用于特定标识符的grep搜索
  → 从不完整重新读取

Layer 4: AutoDream（夜间整合）
  → Orient（定向）- 扫描上下文，识别重要内容
  → Collect（收集）- 收集事实、决策、模式
  → Consolidate（整合）- 合并新旧记忆
  → Prune（修剪）- 丢弃过时或低价值记忆

Strict Write Discipline（严格写入纪律）：

• Agent 只能在确认文件写入成功后更新记忆索引
• 防止用失败尝试污染上下文
• Agent 将自身记忆视为"提示"而非"事实"，行动前验证

1.4 KAIROS / ULTRAPLAN 多 Agent 协调

KAIROS（希腊语"恰当时刻"）：

• 始终在线的自主后台守护进程
• 用户空闲时运行 autoDream 进行夜间记忆整合
• 合并不同观察，移除逻辑矛盾
• 将模糊洞察转化为验证事实
• 支持团队记忆路径（跨团队 Claude Code 实例共享）

ULTRAPLAN：

• 将复杂规划任务卸载到远程 Cloud Container Runtime (CCR)
• 使用 Opus 4.6 模型运行长达 30 分钟
• 用户可从手机或浏览器批准结果
• 特殊哨兵值 __ULTRAPLAN_TELEPORT_LOCAL__ 将结果带回本地

Coordinator Mode：

• 一个 Claude 实例管理多个并行工作 Agent
• 通过邮箱系统协调
• 每个工作 Agent 处理子任务，Coordinator 路由工作并协调结果
• 支持 Unix Domain Socket (UDS) 进程间通信

1.5 40+ 工具系统

权限系统： 每个工具调用通过 6 层安全检查

1. Config allowlist（配置白名单）
2. Auto-mode classifier（自动模式分类器）
3. Coordinator gate（协调器门控）
4. Swarm worker gate（集群工作节点门控）
5. Bash classifier（Bash命令分类器）
6. Interactive user prompt（交互式用户确认）

2. OpenClaw 架构概述

2.1 运行时与架构

2.2 Gateway 控制平面

OpenClaw 的核心架构创新是 Gateway —— 始终在线的控制平面：

┌─────────────────────────────────────────┐
│              Gateway                    │
│  (Port 18789 - 控制平面)                 │
├─────────────────────────────────────────┤
│  - Session Management                   │
│  - Channel Routing                      │
│  - Tool Dispatch                        │
│  - Event Handling                       │
└──────────────┬──────────────────────────┘
               │
    ┌──────────┼──────────┐
    ▼          ▼          ▼
┌───────┐ ┌───────┐ ┌───────────┐
│Slack  │ │Discord│ │Telegram   │
│WhatsApp│ │iMessage│ │Signal    │
│...    │ │...    │ │...       │
└───────┘ └───────┘ └───────────┘

2.3 Skills 插件系统

OpenClaw 使用三层技能系统替代 Claude Code 的内置工具：

技能定义格式（SKILL.md）：

---
name: skill-name
description: 技能描述
metadata:
  openclaw:
    requires: { bins: ["tool"] }
    install: [...]
---

# 使用说明...

2.4 记忆系统

OpenClaw 采用三层记忆架构：

Layer 1: MEMORY.md
  → 长期精选记忆（手动维护）
  → 跨会话持久化

Layer 2: memory/YYYY-MM-DD.md
  → 每日原始日志
  → 自动记录对话

Layer 3: Vector Memory (LanceDB)
  → 语义搜索
  → 自动检索相关记忆

对比 Claude Code：

• OpenClaw 的 MEMORY.md 是用户可编辑的，Claude Code 的是自动生成的索引
• OpenClaw 使用向量数据库，Claude Code 使用文件分层
• Claude Code 有自动"梦境"整合，OpenClaw 需要手动或心跳触发整理

2.5 子 Agent 架构

OpenClaw 已实现 sessions_spawn API 支持子 Agent：

// 派生子Agent
sessions_spawn({
  task: "具体任务描述",
  pattern: "researcher-specialist", // 可选：指定模式
  limits: {
    timeout: 600000,
    // 注意：以下限制在v2规划中，当前仅支持timeout
    // maxMemory: 512,
    // maxCost: 2.00
  }
});

当前限制：

• 仅支持超时终止，不支持资源限制终止
• 无双向通信（子Agent结果自动报告）
• 无 post-mortem 跟踪

3. 架构对比表

3.1 核心特性对比

3.2 工具系统对比

3.3 记忆系统对比

3.4 Agent协调对比

3.5 功能特性对比

4. 可借鉴的设计模式

4.1 高优先级（立即实施）

4.1.1 Strict Write Discipline（严格写入纪律）

问题： OpenClaw 可能在文件写入失败后仍更新记忆，导致记忆污染。

解决方案：

// 在文件写入成功后才能更新记忆
async function writeFileAndUpdateMemory(filePath, content, memoryUpdate) {
  try {
    await fs.writeFile(filePath, content);
    // 确认写入成功后
    await updateMemoryIndex(memoryUpdate);
  } catch (error) {
    // 失败时不更新记忆
    throw error;
  }
}

实施难度： 低
影响： 高（防止记忆污染）

4.1.2 AutoDream 记忆整合

问题： OpenClaw 的记忆需要手动或心跳整理，缺乏自动整合机制。

解决方案：

// 在heartbeat或定时任务中添加
async function autoDream() {
  // 1. Orient - 扫描memory/目录
  const dailyFiles = await scanDailyFiles();
  
  // 2. Collect - 提取关键信息
  const insights = await extractInsights(dailyFiles);
  
  // 3. Consolidate - 合并到MEMORY.md
  await consolidateToMemoryMD(insights);
  
  // 4. Prune - 清理过时内容
  await pruneStaleMemories();
}

实施难度： 中
影响： 高（提升记忆质量）

4.1.3 六层权限系统

问题： OpenClaw 的权限控制较粗粒度。

解决方案：

# 在SKILL.md中添加权限声明
permissions:
  layers:
    - config_allowlist    # 配置白名单检查
    - auto_classifier     # 自动模式分类
    - coordinator_gate    # 协调器授权
    - bash_classifier     # Bash命令分析
    - sandbox_check       # 沙箱验证
    - user_confirm        # 用户确认

实施难度： 高
影响： 高（安全性提升）

4.2 中优先级（近期规划）

4.2.1 BUDDY 终端宠物系统

价值： 增强用户情感连接，提供轻松的使用体验。

简化实现思路：

// 在Terminal UI中添加
class TerminalBuddy {
  constructor(userId) {
    this.species = this.determineSpecies(userId);
    this.stats = { debugging: 0, patience: 0, chaos: 0, wisdom: 0, snark: 0 };
  }
  
  render() {
    // 在终端角落渲染ASCII艺术
    return `[\({this.getEmoji()}]\){this.sayRandom()}`;
  }
}

实施难度： 低
影响： 中（用户体验）

4.2.2 ULTRAPLAN 远程深度规划

价值： 复杂任务需要长时间思考，本地执行可能超时。

实现思路：

• 检测到复杂任务时，提供"深度规划模式"选项
• 将任务上下文发送到远程服务
• 使用更强的模型（Opus级别）进行长达30分钟的规划
• 用户异步接收规划结果

实施难度： 高
影响： 中（复杂任务处理能力）

4.2.3 增强的子Agent资源限制

问题： OpenClaw 子Agent目前仅支持超时限制。

解决方案：

sessions_spawn({
  task: "...",
  limits: {
    timeout: 600000,
    maxMemory: 512,        // MB - 待实现
    maxCost: 2.00,         // USD - 待实现
    maxOutputSize: 10,     // MB - 待实现
    maxToolCalls: 100,     // 待实现
    stuckDetection: {      // 待实现
      enabled: true,
      sameToolRepeat: 5
    }
  }
});

实施难度： 中
影响： 中（成本控制与稳定性）

4.3 低优先级（长期愿景）

4.3.1 团队记忆共享

价值： 团队协作时共享项目上下文。

实现思路：

• 支持团队级 MEMORY_TEAM.md
• 使用共享存储（如飞书文档、Notion）同步记忆
• 权限控制确保敏感信息隔离

4.3.2 语音模式增强

OpenClaw 已有部分语音支持，可参考 Claude Code 的 VOICE_MODE 设计更完整的语音交互体验。

4.3.3 电子宠物变体

在 Canvas 或 Web 界面中实现可视化宠物，而非纯终端版本。

5. 实施路线图建议

第一阶段（1-2周）：基础加固

1. Strict Write Discipline

   • 修改文件写入工具，确保写入成功后才能更新记忆
   • 添加事务性写入支持

2. BUDDY 简化版

   • 在终端输出中添加简单的ASCII宠物
   • 根据用户ID确定性生成物种
   • 添加随机吐槽功能

第二阶段（2-4周）：记忆系统升级

3. AutoDream 自动整合

   • 在 heartbeat 中添加记忆整理任务
   • 实现四阶段整合管道
   • 支持手动触发整理

4. MEMORY.md 格式优化

   • 参考 Claude Code 的轻量级索引格式
   • 添加位置指针而非完整内容

第三阶段（1-2月）：高级功能

5. 权限系统增强

   • 在 SKILL.md 中声明权限需求
   • 实现多层权限检查

6. 子Agent资源限制

   • 内存监控与限制
   • 成本预算控制
   • 死循环检测

第四阶段（3月+）：创新功能

7. ULTRAPLAN 远程规划

   • 集成远程推理服务
   • 异步规划工作流

8. 团队记忆共享

   • 多用户记忆同步
   • 权限与隐私控制

6. 核心发现摘要

6.1 架构哲学差异

6.2 各有优势领域

Claude Code 领先：

• 终端UI体验（Ink）
• 记忆自动整合（Dream系统）
• 权限安全模型
• 远程深度规划（ULTRAPLAN）

OpenClaw 领先：

• 渠道覆盖（20+消息平台）
• 扩展性（Skills系统）
• 多平台支持（iOS/Android/macOS）
• 开源社区生态

6.3 最值得借鉴的设计

1. Strict Write Discipline - 防止记忆污染的关键机制
2. 三层记忆架构 - 分层存储优化上下文使用
3. AutoDream - 自动记忆整合提升长期记忆质量
4. 六层权限 - 深度安全防护模型
5. BUDDY - 人格化设计增强用户体验

6.4 风险提醒

• Undercover Mode 类似功能可能引发伦理争议，不建议实现
• KAIROS 的始终在线模式需考虑隐私和用户授权
• 任何后台自动操作都需明确用户同意机制

附录：参考资源

• Claude Code 泄露源码分析
• OpenClaw 架构文档
• memsearch 记忆系统
• Claude Code 功能泄露清单

报告完成时间：2026-04-02
研究Agent：Agent 4 - OpenClaw对比与可借鉴设计
文件路径：/root/.openclaw/workspace/claude_code_vs_openclaw.md

#ClaudeCode #Anthropic #AIAgent #MCP #架构分析 #代码泄露 #技术报告 #小凯