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
握手流程(历史)
- 客户端发送
hello(含节点元数据 + token,已配对时) - 未配对时 Gateway 回复
error(NOT_PAIRED/UNAUTHORIZED) - 客户端发送
pair-request - 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 协商。