TCP bridge 已移除。当前 OpenClaw 不再启动 bridge 监听器,bridge.* 配置键已从 schema 中删除。本页仅作历史参考。当前节点/operator 客户端请使用 gateway-protocol。

历史背景

Bridge 协议存在的原因:

  • 安全边界:只暴露小型白名单,而非完整 Gateway API
  • 配对 + 节点身份:节点准入由 Gateway 管理,绑定到每节点 token
  • 发现 UX:节点可通过 Bonjour 在 LAN 发现 Gateway
  • Loopback WS:完整 WS 控制面保持本地,需要时通过 SSH 隧道

传输层(历史)

  • TCP,每行一个 JSON 对象(JSONL)
  • 可选 TLS(bridge.tls.enabled: true)
  • 历史默认端口:18790

握手流程(历史)

  1. 客户端发送 hello(含节点元数据 + token,已配对时)
  2. 未配对时 Gateway 回复 error(NOT_PAIRED/UNAUTHORIZED)
  3. 客户端发送 pair-request
  4. Gateway 等待审批,发送 pair-ok 和 hello-ok

帧类型(历史)

Client → Gateway:

  • req/res:范围限定的 Gateway RPC(chat、sessions、config、health 等)
  • event:节点信号(语音转录、agent 请求、exec 生命周期)

Gateway → Client:

  • invoke/invoke-res:节点命令(canvas.*、camera.*、screen.record、location.get)
  • event:订阅会话的 chat 更新
  • ping/pong:保活

Exec 生命周期事件(历史)

节点可发送 exec.finished 或 exec.denied 事件,映射为 Gateway 系统事件。

版本(历史)

Bridge 为隐式 v1,无 min/max 协商。

相关