状态说明：已弃用 (Deprecated) Bridge 协议（TCP/JSONL）已在当前 OpenClaw 版本中移除。
本文档保留作为历史参考，旨在记录 openclaw docker 教程 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://javaforall.net/275421.html原文链接：https://javaforall.net
