OpenClaw结构
OpenClaw是典型的hub-and-spoke结构,即中心辐射型系统设计,其中中心网关作为枢纽,统一协调代理执行、消息通道和本地设备节点。

Gateway:
Gateway 网关是会话、路由和渠道连接的唯一事实来源,是OpenClaw的控制平面。 官方推荐的部署模型是:每台主机一个 Gateway 网关。
Gateway网关的功能:
WebSocket连接管理 RPC方法调度 消息渠道协调 Agent运行编排 系统状态维护
Pi Agent:
Agent分为Agent runner和Agent Loop2个阶段,以及pi-agent-core底层引擎和tools/skills共同组成。
⁘ Agent runner具备6大功能:
Agent Runner是Openclaw的中央协调器(Central Orchestrator),具有如下6个功能:
队列调度(Lane-based Concurrency)
上下文组装(Context Assembly)
模型调用与回退(Model Fallback)
生命周期管理(Lifecycle Management)
事件桥接(subscribeEmbeddedPiSession)+去重机制
错误恢复(Error Recovery)
⁘ Agent loop包含6个阶段:
intake 接收 context assembly 上下文组装 model inference 模型推理 tool execution 工具执行 streaming replies 流式回复 persistence 持久化
⁘ Pi-Agent-Core:
pi-agent-core 只提供 4 个原子工具,read,write,edit,bash. Agent Runner 通过 subscribeEmbeddedPiSession 将 pi-agent-core 的内部事件转换为OpenClaw的标准流。
⁘ Tools:
Model Inference判断是否需要调用Tools execute,如果需要Tools execution后并将结果回填反馈给Model,从而实现ReAct(Reasoning + Acting)模式,其中model inference隐式think和reflect,tool execution对应Act,结果的回填对应Observe。
Tools policy以及控制流程请参考前文:
Native Clients (macOS / iOS / Android)
这些本地节点连接到Gateway提供硬件级别的能力(照相,定位等)给AI Agent。
Sandboxing Architecture
为了安全执行工具和代码,Openclaw提供了沙箱机制,包括docker,ssh,openshell。
Sandbox机制和使用参考前文:
夜雨聆风