核心用法
AgentRelay 是一套专为 AI 智能体设计的点对点通信协议，主要解决 sessions_send 方法在传输超过 30 字符消息时的超时问题。其核心机制是将大载荷数据写入共享 JSON 文件，仅通过简短的 CSV 格式指针消息（如 REQ,r1_r,s/r1_r.json,,）在智能体间传递引用。
主要命令：
receive <csv_message>：解析消息并读取共享文件内容，返回包含任务详情和密钥的 JSONupdate <event_id> <json_updates>：更新共享文件中的任务状态或结果ack <event_id> <secret>：生成 ACK 确认消息，完成握手闭环
显著优点
1. 突破传输限制：通过文件中转规避了消息通道的字符数限制，支持任意大小的数据交换
2. 可靠交付机制：采用 REQ-ACK 双阶段确认，配合 6 位随机密钥验证，确保接收方确实读取了文件
3. 安全增强：可选的 burn-on-read 机制实现阅后即焚，配合 SHA-256 完整性校验防止篡改
4. LLM 友好：明确的 AgentRelay: 前缀触发器，使语言模型能自动识别并调用对应技能处理
潜在局限
- 依赖共享存储：需要智能体间可访问的共享文件系统，分布式部署时配置复杂
- 延迟较高：相比直接消息传递增加了文件 I/O 操作，不适合超低延迟场景
- 状态管理：24 小时默认 TTL 需要配套清理机制，长时任务需显式续期
- 单点故障风险：共享存储若不可用则整个协议瘫痪
适合人群
- 多智能体协作系统中需要传输结构化数据（JSON、配置、中等规模文档）的开发者
- 使用 OpenClaw 或类似框架构建 agent 网络的工程师
- 需要可靠异步通信且可接受秒级延迟的 AI 工作流场景
常规风险
- 密钥泄露：Secret Code 在 ACK 阶段以明文传输，若消息通道被截获可能导致伪造确认
- 文件权限：共享目录权限配置不当可能导致未授权读取或写入冲突
- 路径遍历：文件指针解析需严格校验，防止
../等恶意路径构造 - TTL 竞态：高并发场景下文件可能被提前清理导致读取失败