第九章 Gateway 控制平面与协议机制

本章切换到系统内核视角，讨论 OpenClaw Gateway 的控制平面职责、连接生命周期、事件一致性与设备配对及信任建立。通过本章，你将理解一个健壮的 Gateway 如何通过精心设计的协议与状态机，让分布式智能体系统变得“可预测、可恢复、可审计”。

理解这一章的价值在于：同样的模型能力，在不同控制平面设计下会呈现完全不同的稳定性与安全性。

本章内容导读

本章包括以下几个小节：

• 9.1 架构全景与五平面框架：用五平面架构（控制、数据、上下文、信任、可观测性）建立统一的系统设计视角。

• 9.2 控制平面职责与边界：深入控制平面的五大职责——认证、路由、会话管理、策略执行与故障恢复。

• 9.3 连接生命周期：握手、认证与心跳：理解 WebSocket 长连接的完整生命周期、握手、认证与保活机制。

• 9.4 事件幂等与一致性保障：掌握事件驱动系统的幂等与一致性：用 idempotencyKey 处理副作用重试，用 seq gap 触发状态刷新。

• 9.5 渠道配对与本地信任建立：理解渠道 sender 配对、设备配对与 setup code / bootstrap token 的边界，以及吊销与轮换的治理方法。

• 9.6 本章小结：关键结论与读者自检。

学习目标

完成本章的阅读后，你将能够：

1. 理解架构：从控制平面的视角看 Gateway 的整体设计。

2. 掌握协议：理解 WebSocket 连接的完整生命周期。

3. 保障一致性：设计事件驱动系统中的幂等与一致性机制。

4. 建立信任：通过设备配对与密钥管理建立安全的信任基础。