跳到主要内容

OpenClaw 源码解析

这条资源在讲什么​

这条资源不是在重新定义 Agent，也不是在讲一个最小 demo 怎么跑起来。它选了一条更硬的路：直接围绕 OpenClaw 这个真实开源项目，从源码层面把系统是怎么搭起来的讲清楚。

仓库 README 对它的定位很直接：OpenClaw 不是模型本身，而是一个个人 AI 助手的控制平面，会把 WhatsApp、Telegram、Slack、Discord 等多种聊天渠道统一接入，再把请求路由给 Claude、GPT 等模型，然后把回复分发回去。

所以这本书真正关心的是：

  • 这种 AI 助手网关的整体骨架是什么
  • 一条消息怎么进系统、怎么出系统
  • Agent 运行时、工具、记忆、Sandbox、Browser、Skills、Sub-agent 这些机制在真实项目里怎么落位
  • 扩展体系和安全模型为什么要这样设计

适合谁​

  • 已经看过一些 Agent 概念或框架资料，想进入真实大型项目源码的人
  • 对消息网关、控制平面、运行时编排这类系统问题感兴趣的人
  • 想通过源码分析来理解 Agent 产品级系统的人

不太适合谁​

  • 现在只想快速知道“Agent 是什么”的人
  • 对 TypeScript 大项目、消息系统和工程细节不感兴趣的人
  • 还没建立基本 Agent 心智模型，就想直接啃大型源码导读的人

我为什么把它收进来​

  • 它提供的是“从真实项目倒推系统设计”的学习路径，这和前面几条资源都不一样
  • 它不是只看 agent loop，而是把消息入口、控制平面、运行时、扩展和安全放在同一张图里看
  • 它有很明确的阅读建议和章节分层，适合按主题拆着读，不必硬啃全书

建议怎么用​

我不会把这条资源当第一条学习材料，也不会把它当成“顺着看完就算掌握”的线性教程。

我更推荐这样用：

  1. 先看项目定位、仓库结构和 Gateway 控制平面，先建立整体认知。
  2. 再看消息入境/出境和媒体、Cron 这一段，搞清一条真实消息链路怎么穿过系统。
  3. 等有了全局图，再进入 Pi 引擎、上下文、记忆、工具、Sandbox、Browser、Skills、Sub-agent、ACP 这些运行时主题。
  4. 最后按需补扩展体系和安全模型，不要一上来就平均用力。

这条资源的三个入口​

版权说明​

这里记录的是我自己的笔记和判断，不搬运原书或原项目源码内容。使用时以原站点和仓库说明为准。