Keep Protocol

核心用法

keep-protocol 是一个专为 AI Agent 协作设计的轻量级通信协议，基于 TCP + Protobuf 构建。核心交互模式为：Agent 向指定端点（默认 localhost:9009）发送签名 Packet，服务端验证 ed25519 签名后解析处理，返回 "done" 确认。支持语义化路由（如 swarm:sailing-planner）和可选的内存共享机制（scar）。

技术栈

• 传输层: 纯 TCP，默认端口 9009
• 序列化: Protocol Buffers（高效、强类型）
• 身份验证: ed25519 数字签名
• 反垃圾: 内置 fee（费用）+ ttl（生存时间）字段

显著优点

1. 极简架构：无重量级依赖，Docker 一键部署，适合边缘设备
2. 密码学安全：ed25519 提供现代椭圆曲线安全级别，签名验证失败静默丢弃，避免信息泄露
3. 语义路由：dst 字段支持冒号分隔的命名空间，便于构建多 Agent swarm 拓扑
4. 生态集成：官方提供 Python SDK，OpenClaw 原生提示词支持，降低接入门槛

潜在局限

• 传输可靠性：基于裸 TCP，无内置断线重连、消息去重或 QoS 机制，需应用层保障
• 隐私性缺失：无端到端加密，签名仅保证完整性而非机密性，敏感载荷需额外加密层
• 中心化风险："done" 应答模式隐含对服务端的完全信任，relay 节点可能成为单点故障或审查点
• 经济模型未明：fee 字段仅作结构占位，无内置结算或防女巫攻击的完整机制

适合人群

• 构建多 Agent 系统的开发者（尤其 OpenClaw 生态用户）
• 需要轻量级、可自托管的 Agent 协调层，而非重量级框架（如 LangChain 服务网格）
• 对延迟敏感、愿意牺牲部分可靠性换取极简部署的边缘 AI 场景

常规风险

• 密钥管理：ed25519 私钥若硬编码或日志泄露，攻击者可伪造任意 Agent 身份
• DoS 攻击：虽设 fee/ttl，但无 rate limiting 描述，低费用包仍可能耗尽连接池
• 协议演化：Protobuf schema 变更若无版本协商，可能导致新旧节点互操作失败
• 供应链：依赖 Docker 镜像 ghcr.io/clcrawford-dev/keep-server，需验证镜像签名与更新策略

核心用法

keep-protocol 是一款专为 AI Agent 设计的轻量级通信协议，通过 TCP + Protobuf 实现 Agent 间的安全消息传递。核心使用方式包括：

服务端部署：通过 Docker 一键启动本地服务器（默认端口 9009），接收来自其他 Agent 的 Packet 消息。

客户端调用：支持自然语言指令或 Python SDK 发送消息，需指定 src（发送方标识）、dst（目标路由，支持语义化如 swarm:sailing-planner）、body（消息内容），并配置 fee（防垃圾费）和 ttl（生存时间）。

安全验证：所有消息必须使用 ed25519 私钥签名，服务端验证签名有效性后返回 "done" 确认，无效签名则静默丢弃。

显著优点

1. 轻量高效：340行Go代码实现完整协议栈，Protobuf 二进制编码相比 JSON 减少 30-50% 传输开销
2. 原生安全：ed25519 现代签名算法提供身份认证 + 完整性保护，无需额外 TLS 层即可防篡改
3. 语义路由：dst 字段支持层级命名空间，便于构建去中心化 Agent 网络拓扑
4. 抗 spam 设计：fee 字段为经济层扩展预留接口，ttl 防止消息无限重播
5. 可选内存共享：scar 扩展支持 Agent 间状态同步

潜在局限

• 个人开发者维护：作者为 nTEG, LLC CEO 的个人账号，项目创建于 2026 年 1 月，社区成熟度待验证
• 无内置加密：TCP 明文传输，敏感场景需额外 TLS 或 VPN 隧道
• 功能极简：无持久化、无集群共识、无重试机制，需自行搭建高可用架构
• 日志脱敏不足：当前实现会记录完整 body 内容，生产环境需改造

适合人群

• 多 Agent 系统的原型开发者，需快速验证协调机制
• 隐私优先场景，希望避免中心化消息队列（如 RabbitMQ/Kafka）的运维负担
• 区块链/Web3 背景开发者，熟悉 ed25519 和 gas/fee 模型
• 边缘计算场景，需要低开销的 Agent 间通信

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 供应链攻击 | 低 | 仅依赖官方 Protobuf 库，无已知 CVE |

| 签名伪造 | 低 | ed25519 算法安全，但需妥善保管私钥 |

| 拒绝服务 | 中 | 无速率限制，超大包可能消耗内存 |

| 数据泄露 | 中 | TCP 明文传输，中间人可见元数据 |

| 项目弃用 | 中 | 个人项目，长期维护存在不确定性 |

生产建议：在信任网络内部署，配合 WireGuard/Tailscale 等 overlay 网络加密；关键业务场景前进行代码审计并参与社区贡献。