学习路线图:从看懂到复刻

目标:把“看懂实现”变成“能复刻同类项目的关键骨架”。

推荐顺序(按这个读最省时间)

  1. 术语速查
  2. 网关控制平面
  3. 智能体执行框架(run/attempt/订阅/回退)
  4. 会话与并发(sessionKey/lane/queue)
  5. 工具策略与执行审批(tool policy + exec approvals)
  6. 生命周期与运维(热更/重启/关停)

进阶模块(按需选择)

当你要把系统推向“长期可用、可扩展、可复刻”的工程质量,可以按需补齐这些模块:

  1. 五件套总览(把机制拼成骨架)
  2. 上下文工程(窗口守卫/卫生/压缩恢复)
  3. 模型回退与鲁棒性(错误归一化 + attempts 轨迹)
  4. 记忆系统(qmd/builtin 回退 + 注入上限)
  5. Hook 与插件治理(优先级/并行/故障隔离)
  6. 子智能体与技能快照(spawn/恢复/热更新)

读到每一章时,建议用同一条“可观察链路”贯穿验证:

  • 启动:openclaw gateway
  • 观测:openclaw logs --follow
  • 交互:openclaw dashboard(Control UI)

硬验收(用最少动作验证理解)

  1. 能说明为什么 chat.send ACK 很快、回复为何走事件流(参见 Control UI)。
  2. 能解释为什么同一 sessionKey 不乱序,不同会话能并行(参见 队列与 Lane)。
  3. 能解释工具安全三层(sandbox / policy / approvals)各自负责什么(参见 Sandbox vs tool policy vs elevated)。
  4. 能在日志里定位一次 run(从 runId 追到会话/工具/最终回复)(参见 日志)。