一条消息怎样跑完整个 Agent 回合
从 ChannelPlugin 接住消息,一路追到 sessionKey、执行队列、Embedded Agent、工具事件和最终 ReplyPayload。
阅读全文 →源码阅读 · 八篇路线
OpenClaw 的难点不在模型怎样生成一句回复,而在消息怎样进入正确会话、工具何时可以执行、子任务怎样回传,以及进程重启后哪些工作可以安全继续。这八篇沿同一个源码快照,从一次消息处理逐步读到常驻运行与恢复。

怎么读。第一次了解 OpenClaw,建议按 01–08 顺序阅读;正在排查具体问题,可以直接从路由、上下文、能力、安全或恢复篇进入。每篇开头都会说明前置知识,结尾保留对应源码与官方文档。
从 ChannelPlugin 接住消息,一路追到 sessionKey、执行队列、Embedded Agent、工具事件和最终 ReplyPayload。
阅读全文 →区分 operator、node 与受限 worker 入口,跟随握手、授权和事件投递,理解断档后为何要重新读取状态。
阅读全文 →看 Binding、dmScope、groupScope 与 identityLinks 怎样生成 sessionKey,并比较 Steer、Followup、Collect、Interrupt 的执行顺序。
阅读全文 →分清本轮模型输入、持久历史与摘要视图,理解 Memory、Pruning、Compaction 及回复后的会话维护。
阅读全文 →沿工具发现、注册与 Policy 过滤,区分普通工具、宿主单独授权能力,以及直接 Schema 和延迟工具目录。
阅读全文 →分清 Tool Policy、Sandbox、Exec Approval 与 Elevated Mode,逐步判断谁能用哪个工具、访问什么资源、执行哪条命令。
阅读全文 →比较配置级 Agent、Native Subagent 与 ACP Harness,再看子任务获得什么身份、上下文和权限,完成后怎样回到父任务。
阅读全文 →分清 Heartbeat、Automations、Background Tasks 与 Restart Recovery 怎样定时、记录、投递,并在结果不确定时停止重放。
阅读全文 →