乐于分享
好东西不私藏

OpenClaw结构Overview

OpenClaw结构Overview
OpenClaw结构

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

Gateway:

Gateway 网关是会话、路由和渠道连接的唯一事实来源,是OpenClaw的控制平面。 官方推荐的部署模型是:每台主机一个 Gateway 网关

Gateway网关的功能:

  1. WebSocket连接管理
  2. RPC方法调度
  3. 消息渠道协调
  4. Agent运行编排
  5. 系统状态维护
Pi Agent:

Agent分为Agent runner和Agent Loop2个阶段,以及pi-agent-core底层引擎和tools/skills共同组成。

Agent runner具备6大功能:

Agent Runner是Openclaw的中央协调器(Central Orchestrator),具有如下6个功能: 

  1. 队列调度(Lane-based Concurrency) 

  2. 上下文组装(Context Assembly) 

  3. 模型调用与回退(Model Fallback) 

  4. 生命周期管理(Lifecycle Management) 

  5. 事件桥接(subscribeEmbeddedPiSession)+去重机制 

  6. 错误恢复(Error Recovery)

Agent loop包含6个阶段:
  1. intake 接收
  2. context assembly 上下文组装
  3. model inference 模型推理
  4. tool execution 工具执行
  5. streaming replies 流式回复
  6. 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以及控制流程请参考前文:

Tools Policy工具策略配置与使用

Tools控制流程(包含elevated流程)

Native Clients (macOS / iOS / Android)

这些本地节点连接到Gateway提供硬件级别的能力(照相,定位等)给AI Agent。

Sandboxing Architecture

为了安全执行工具和代码,Openclaw提供了沙箱机制,包括docker,ssh,openshell。 

Sandbox机制和使用参考前文:

Sandbox的机制和使用