PiMono Agent 框架源码精读PiMono Agent Framework: Source Code Deep Dive

为什么读 Agent 源码Why Read Agent Source Code

从"通用助手"到"AI 员工"，Agent 好像正在接管世界。大模型的魔力我们可以通过聊天直观感知，那 Agent 的魔力从哪里来，比大模型多了什么？弄清楚这个问题最好的方法是去看 Agent 源码。

From "general assistants" to "AI employees," Agents seem to be taking over the world. We can intuitively feel the magic of large language models through chatting — but where does the Agent's magic come from? What does it add beyond the LLM itself? The best way to answer that question is to read Agent source code.

PiMono 是 OpenClaw 的内核引擎。核心只有 5 个文件、2002 行代码，但体现了所有 Agent 的通用模式 —— 代码量最少，模式最完整，理解 Agent 核心性价比最高的一次阅读。

PiMono is the kernel engine of OpenClaw. Its core is just 5 files and 2,002 lines of code, yet it embodies all universal Agent patterns — the least code, the most complete patterns, and the highest return-on-investment reading for understanding how Agents work.

这份笔记来自非技术背景的自学者。阅读方法：先看架构全景图建立整体感 → 每章上篇是左源码右中文讲解，逐行过一遍 → 下篇是提炼后的中文模块概览，梳理全貌 → 打印下篇反复看，直到变成直觉。所有术语即时解释，从前往后读就好。

These notes are from a self-taught learner with a non-technical background. Reading approach: start with the architecture overview to build the big picture → each chapter's Part A has source code on the left and explanations on the right, going line by line → Part B is a distilled module overview → print Part B and review until it becomes intuition. All terms are explained inline — just read from start to finish.