OpenClaw 源码深度研究

对 openclaw/openclaw @ v2026.4.15 的系统性源码阅读与生态调研。

采集基线日期：2026-04-17；数据覆盖：2026-02-01 以来约 23,014 条 commit、1,200 条 merged PR、420 条 issue、300 个最新 fork + 240 个 star≥3 的 fork + 20 个衍生仓库。

系列研究

本研究是 AI Agent / Coding Harness 源码深度研究系列的一部分，姊妹篇：

• Claude Code 源码解析 — Anthropic Claude Code v2.1.88 完整 Agent Harness 拆解（30 篇 / 23 个子系统 / 179 张架构图）
• OpenAI Codex 源码深度研究 — OpenAI Codex CLI + Rust workspace + TS/Python SDK 全栈（27 篇 / ~51 万字 / 149 张 Mermaid 图）
• Hermes Agent 深度研究 — Hermes Agent + 4 个同源/对比项目（OpenClaw / EvoMap / OpenHarness / JiuwenClaw），含抄袭分析（38 篇 / 32 章 / 97 张架构图）

快速导航

• 初次进入：Appendix D 封面与阅读路径 按角色选读 20-40 min
• 想一次性看懂：从 总纲 — OpenClaw 技术主线分析 开始
• 想了解外界怎么看：读 全网调研 — 社区认知地图
• 架构设计：Part I
• 执行链路：Part II
• 通道与模型：Part III
• 生态演进：Part IV（直接回答"社区关注什么"）
• 缺陷与未来：Part V（直接回答"优化方向"）
• 只读结论：第 27 章 结语 全景与判断
• 需要原始数据：Appendix

全部章节

总纲与调研

• 总纲 — OpenClaw 技术主线分析
• 全网调研 — 社区认知地图

Part I Architecture and Philosophy — 架构与设计哲学

1. 01 项目定位与 Molty 愿景
2. 02 Gateway 控制面总览
3. 03 Agent 与 Session 模型
4. 04 Context Engine 与记忆体系
5. 05 插件与扩展机制
6. 06 Skill 体系与 ClawHub

Part II Source Execution — 源码执行链路

7. 07 启动与进程模型
8. 08 CLI 与命令体系
9. 09 路由 Hooks 与 Auto-reply
10. 10 Tools Canvas 与 Nodes
11. 11 实时语音与转写
12. 12 多媒体生成与理解
13. 13 安全 沙箱与配对

Part III Channels Extensions Apps — 通道 / 模型 / 客户端

14. 14 Channels 抽象与 DM 策略
15. 15 模型提供方接入全景
16. 16 中国区生态适配
17. 17 Skills 实战剖析
18. 18 macOS 菜单栏 App
19. 19 iOS 与 Android 节点

Part IV Variants and PR Evolution — 变种生态与演进（用户问 2）

20. 20 活跃 Fork 与变种生态
    • 20A 深度研究 Fork 三题（fork metric FDR / openclaw-cn 全解剖 / 回流四因）
21. 21 同类 AI 助手横向对比
    • 21A 深度研究 Peer 三题（Gateway 分水岭 / 5 商业模式 / 迁移工程）
22. 22 二月至今 PR 演进全景
    • 22A 深度研究 PR 三题（TTM 双峰 / CVE 全追踪 / 贡献者同心圆）
23. 23 社区关注的能力增强
    • 23A 深度研究 需求与路线图三题（WeCom ROI / Persona workflow / RICE 敏感度）

Part V Issues and Roadmap — 缺陷分析与优化建议（用户问 3）

24. 24 Issues 与抱怨聚类
25. 25 源码层设计问题
26. 26 重点优化方向建议
27. 27 结语 全景与判断

Appendix 附录与原始数据集

• Appendix 目录说明
• Appendix A 章节配置与源码路径
• Appendix D 封面与阅读路径
• 原始数据集：Appendix/B-pr-issue-dataset/20260417
• Fork 榜：Appendix/B-pr-issue-dataset/20260417/fork-activity-rank.md

研究方法

本研究遵循 source-deep-research 7 阶段工作流：

1. 通读源码，产出 27 章骨架（scripts/chapters.yaml，构建后随 scripts/ 一起不发布）
2. 全网调研（2026-02 ~ 2026-04 中英文资料），写两篇总纲
3. Part IV/V 专属数据采集：PR、Issue、Fork、Commits 四路并行
4. 27 章按"七维框架"（外部视角 → 本质 → 痛点 → 方案 → 实现 → 易错 → 竞品 → 缺陷）写作
5. 交叉 review（源码引用存在性、Mermaid 白底板、导航一致性）
6. 系统化整理（本 README、Appendix 索引、命名规范）
7. 仓库构建与发布

致谢

• 研究对象：openclaw/openclaw 及全体 contributor（特别是 Peter Steinberger、Vincent Koc、Takhoffman、mbelinky、gumadeiras 等）
• 生态数据：GitHub REST API + 社区 awesome 列表 + 中英文技术媒体
• 相关研究对照：本仓库同目录 hermes-agent-study 与 claude-code-source-analysis

许可

本研究为独立分析，所有源码引用遵循原项目 License。研究文本本身采用 CC BY-SA 4.0。