本页内容

本页内容

网关

网关协议

网关 WS 协议是 OpenClaw 的单一控制平面和节点传输层。操作员和节点客户端(CLI、Web UI、macOS app、iOS/Android nodes、无头节点)通过 WebSocket 连接,并在握手时声明一个角色和作用域。

网关内运行的代理工具直接通过该网关的路由器调度请求。他们保留方法范围、代理和批准权限、请求截止日期和取消,而无需打开另一个 WebSocket。显式网关 URL 或令牌覆盖、独立代理和单独的客户端进程继续使用 WebSocket 传输。

范围

此协议公开了完整的 gateway API:状态、频道、模型、聊天、代理、会话、节点、审批等。其确切接口由从 packages/gateway-protocol/src/schema.ts 重新导出的 TypeBox schemas 定义。

每页涵盖的内容

  • 传输和成帧 — 网关 WS 传输:包、帧形状、限制和 WebRTC 通话控制。
  • 握手和角色 — 连接帧、hello-ok 有效负载、客户端功能、角色和范围。
  • 存在和事件 — 存在快照、节点主机统计数据和广播事件范围。
  • RPC 方法 — RPC 方法系列、发现、会话列表引导和事件系列。
  • Ledger RPC — 审核账本 RPC、其范围、游标和有效负载。
  • 操作员方法 — 操作员辅助方法、执行批准和代理交付回退。
  • Versioning — 协议版本常量、N-1 节点窗口和客户端默认值。
  • Auth 和设备身份 — 握手身份验证路径、设备身份、配对签名和 TLS 固定。

各部分移动的地方

先前单页版本中的每个部分标题都保留其锚点,因此带有片段的指向此页面的现有链接仍然可以解析。每个条目都指向现在保存内容的页面。

相关内容

本页有帮助吗?