学习资源
本页给出一条“从会用到看懂源码”的阅读路线。目标不是背 API，而是能回答这些问题：
- OpenClaw 从哪里启动？
- Gateway 怎么把消息接进来并分发？
- 路由如何选择 agent/session？
- Agent 回复是如何生成、如何调用工具、如何做回退？
- 为什么同一会话不会乱序？为什么群组不会串线？
先把系统跑起来（给源码阅读做“可验证环境”）
如果你还没跑通最短链路，先走：
建议至少能完成一次验证：
openclaw gateway status能看到网关在跑openclaw dashboard能打开 Control UI 并完成一次对话
阅读路线（建议顺序）
1) 先看“总览图”，建立脑内地图
这页的定位是“看完后知道每一层在做什么、去哪个文档/模块找细节”。
如果你更偏好“按工程调用链/按框架模块”来读，可以继续看：
2) 再把“数据平面”看懂：Gateway WS 协议 + 方法分组
- TypeBox 协议与方法表
- Gateway 协议
- Control UI（里面列了它用到的 WS 方法）
你需要能说清楚：connect → subscribe → call(chat.send) 的基本交互，以及为什么 chat.send 是非阻塞的、响应如何通过事件流回来。
3) 然后看“执行平面”：Agent loop（run/attempt）与队列
你需要能说清楚：为什么要按 sessionKey 排队（lane），以及“一个会话同一时间只有一个 active run”如何保证消息不乱序。
4) 再看“安全边界”：Sandbox、工具策略、审批
你需要能说清楚：为什么“工具安全”必须代码约束，而不是只靠提示词；以及高风险工具如何触发审批与超时处理。