本页内容
本页内容
网关
网关协议
网关 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 固定。
各部分移动的地方
先前单页版本中的每个部分标题都保留其锚点,因此带有片段的指向此页面的现有链接仍然可以解析。每个条目都指向现在保存内容的页面。
- npm 封装
- 运输和装框
- 网关控制 WebRTC Talk
- 握手
- Worker角色和封闭协议
- 客户端功能
- 节点连接示例
- 角色和范围
- [Caps/commands/permissions(节点)](</gateway/protocol/handshake#caps%2Fcommands%2Fpermissions-(node)>)
- Caps/commands/permissions(节点)
- 存在
- 节点主机统计
- 节点后台活动事件
- 广播事件范围
- RPC 方法系列
- 系统和身份
- 模型及用途
- 频道和登录助手
- 插件管理
- 消息和日志
- 操作员终端
- Talk 和 TTS
- 机密、配置、更新和向导
- 代理和工作区助手
- 会话控制
- 设备配对和设备令牌
- 节点配对、调用和挂起工作
- 批准系列
- 控制UI命令
- 自动化、技能和工具
- 会话列表引导
- 常见事件系列
- 节点辅助方法
- 节点执行生命周期事件
- 审计账本 RPC
- 操作员帮助方法
models.list浏览次数models.list浏览次数- 执行批准
- 代理发货回退
- 版本控制
- 客户端常量
- Auth
- 设备身份和配对
- 设备身份验证迁移诊断
- TLS 并固定
相关内容
- 构建网关客户端
- 嵌入 OpenClaw
- Gateway 运行手册
- 操作员范围 — 范围协议方法被授权
- 审核历史记录 — 仅元数据活动历史记录和决策收据
- Pairing — 批准谁可以 DM 您以及哪些节点可以加入
- Cloud Workers — 通过此协议驱动的工作会话
- Tools 调用 API — 通过网关 HTTP 端点直接调用单个工具
本页有帮助吗?