状态说明:已弃用 (Deprecated) Bridge 协议(TCP/JSONL)已在当前 OpenClaw 版本中移除。
本文档保留作为历史参考,旨在记录 OpenClaw 架构演进的设计思路与经验教训。
在 OpenClaw 的早期架构中,Bridge 协议是基于 TCP + JSONL (JSON Lines) 的节点通信标准。它在特定历史阶段解决了三个核心痛点:
随着架构成熟,这些需求已被更统一的 Gateway WebSocket 协议 完美覆盖,双协议栈反而成为了维护负担。
传输层特性
安全警示:mDNS TXT 记录未经签名验证。客户端绝不可将广播的 TLS 指纹视为权威信任锚,必须通过带外验证或用户确认。
握手与配对流程
Bridge 设计了严格的“先配对,后通信”流程:
消息帧类型体系
典型事件:执行生命周期
节点通过 或 上报本地命令执行结果:
从 TCP Bridge 到 Unified WebSocket 的演进,是架构简化的必然选择。
核心驱动力
对于节点客户端开发者
1. 连接层变更
2. 认证逻辑变更
3. 消息兼容性
对于网关运维者
Bridge 协议虽然已退场,但其蕴含的设计原则被 Gateway 协议完整继承并发扬光大:
值得保留的遗产
演进带来的思考
Bridge 协议是 OpenClaw 成长路上的重要里程碑。它证明了安全边界和显式授权在 AI 网关架构中的核心价值。
虽然具体的实现技术从 TCP/JSONL 演进到了 WebSocket/JSON,但核心设计哲学从未改变:
在便利性与安全性之间寻找平衡,在灵活性与标准化之间选择务实。
对于历史研究者,Bridge 文档是一份珍贵的档案;对于现行开发者,请记住:忘掉 TCP 端口,拥抱 WebSocket,让连接更简单,让安全更内建。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/239701.html