实践openclaw-concepts
Gateway architecture · OpenClaw — 一个网关管理所有消息面，客户端与节点分离，协议严格类型化。
一个网关管理所有消息面，客户端与节点分离，协议严格类型化。
2026-06-29原文
本文为要点摘要，完整细节以原文为准。
- 单一 Gateway 进程持有所有消息通道（WhatsApp、Telegram 等），控制面客户端和节点均通过 WebSocket 连接，但角色不同：客户端发送请求、订阅事件；节点声明
role: node并暴露能力（如canvas.*、camera.*）。- 含义：Agent 的通信层应区分控制面与执行面，节点通过声明式能力注册实现可扩展的远程操作。
- 连接生命周期强制先发送
connect帧，握手后通过hello-ok获得快照（presence + health），后续请求/响应和事件推送均基于此会话。- 含义：Agent 的 WebSocket 协议应设计明确的握手与状态同步阶段，避免无状态乱序消息。
- 幂等键（idempotency keys）对
send、agent等副作用方法必须，服务器保留短时去重缓存；配对需设备身份、挑战签名和显式审批。- 含义：Agent 的远程调用应内置幂等机制，配对流程需结合身份认证与本地信任模型，防止未授权接入。