源码阅读 · 八篇路线

OpenClaw:把“会聊天”读成“能常驻”

OpenClaw 的难点不在模型怎样生成一句回复,而在消息怎样进入正确会话、工具何时可以执行、子任务怎样回传,以及进程重启后哪些工作可以安全继续。这八篇沿同一个源码快照,从一次消息处理逐步读到常驻运行与恢复。

OpenClaw 八篇源码阅读路线:主线、Gateway、路由与会话、上下文与记忆、能力装配、安全边界、多 Agent、常驻与恢复

怎么读。第一次了解 OpenClaw,建议按 01–08 顺序阅读;正在排查具体问题,可以直接从路由、上下文、能力、安全或恢复篇进入。每篇开头都会说明前置知识,结尾保留对应源码与官方文档。

01 · 主线

一条消息怎样跑完整个 Agent 回合

从 ChannelPlugin 接住消息,一路追到 sessionKey、执行队列、Embedded Agent、工具事件和最终 ReplyPayload。

阅读全文 →
02 · Gateway

Gateway 为什么是控制平面

区分 operator、node 与受限 worker 入口,跟随握手、授权和事件投递,理解断档后为何要重新读取状态。

阅读全文 →
03 · 路由与会话

消息究竟属于哪段历史

看 Binding、dmScope、groupScope 与 identityLinks 怎样生成 sessionKey,并比较 Steer、Followup、Collect、Interrupt 的执行顺序。

阅读全文 →
04 · 上下文与记忆

模型这一轮究竟看见了什么

分清本轮模型输入、持久历史与摘要视图,理解 Memory、Pruning、Compaction 及回复后的会话维护。

阅读全文 →
05 · 能力装配

安装的能力怎样变成本轮工具

沿工具发现、注册与 Policy 过滤,区分普通工具、宿主单独授权能力,以及直接 Schema 和延迟工具目录。

阅读全文 →
06 · 安全边界

四道检查各自保护什么

分清 Tool Policy、Sandbox、Exec Approval 与 Elevated Mode,逐步判断谁能用哪个工具、访问什么资源、执行哪条命令。

阅读全文 →
07 · 多 Agent

委派怎样继承与交付

比较配置级 Agent、Native Subagent 与 ACP Harness,再看子任务获得什么身份、上下文和权限,完成后怎样回到父任务。

阅读全文 →
08 · 常驻与恢复

Agent 怎样跨时间继续工作

分清 Heartbeat、Automations、Background Tasks 与 Restart Recovery 怎样定时、记录、投递,并在结果不确定时停止重放。

阅读全文 →