前言 — 为什么要读一个 Agent 项目的源码

OpenClaw 用五个月从零增长到 GitHub 上 Stars 最多的软件仓库。它的项目背景和发展历程，第 1 章会详细展开。

这本书不关心 OpenClaw 的故事有多传奇。我们关心的是它的 140 万行 TypeScript 代码背后的工程决策。这些代码覆盖了构建一个工业级 Agent 系统需要面对的几乎所有核心问题：

这些问题，不是看几篇博客就能搞明白的。它们需要看实际的代码，看真实的设计取舍，看工程师在面对矛盾约束时做出的选择。

这本书逐一拆解这些问题。

源码与项目

本书分析的是 OpenClaw（https://github.com/openclaw/openclaw）的源码，一个基于 MIT 协议开源的个人 AI 助手项目。书中所有源码引用都标注了文件路径和行号，建议 clone 源码仓库后对照阅读：


git clone https://github.com/openclaw/openclaw.git

本书基于 2026.4.x 版本。源码更新很快，具体实现可能变化，但核心架构和设计思路短期内不会有大的变动。

Mini OpenClaw 实战项目的完整代码位于本书配套仓库中，可以直接下载运行。

这是一本源码解读，不是使用教程也不是 API 文档。我们要做的是：拆解每个关键子系统的设计动机和实现方式，讲清楚”为什么这么做”以及”代价是什么”。

全书 34 章，体量不小。根据你的目标，推荐三条阅读路线：

快速了解路线（适合需要概要理解的人）： ch01（全景）→ ch04（Gateway）→ ch09（工具系统）→ ch15（Memory）→ ch34（设计模式）

系统学习路线（适合需要全面掌握的人）：顺序阅读第一到第七部分，跳过 ch20（Canvas）和 ch21（Voice）如果你的场景不需要可视化和语音交互。

动手实战路线（适合先跑起来再说的人）： ch03（快速上手）→ ch29-33（Mini OpenClaw）→ ch27-28（开发 Skill 和 Channel）→ 按需回头读对应章节。

各部分的定位：

第一部分（ch01-03）建立全局认知——项目背景、工程结构、本地跑起来
第二到第四部分（ch04-16）是核心内容——Gateway、Agent Runtime、Workspace Kernel 三大子系统的深度剖析
第五到第六部分（ch17-22）讲平台接入和交互前沿——多渠道、多 Agent、Canvas、Voice。其中 ch20 和 ch21 面向需要可视化/语音交互的读者，可按需跳过
第七部分（ch23-26）讨论安全和生产部署，用真实漏洞案例和攻击数据说明问题
第八部分（ch27-33）是全书的动手环节——开发 Skill、开发 Channel Extension、从零构建 Mini OpenClaw
第九部分（ch34）把全书提炼为 10 个可迁移的设计模式

感谢 Peter Steinberger 和 OpenClaw 社区的所有贡献者。开源让这样的学习成为可能。