Gateway architecture · OpenClaw — 一个网关管理所有消息面，客户端与节点分离，协议严格类型化。

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

原文：Gateway architecture · OpenClaw