AgentRelay 技能综合评估
核心用法
AgentRelay 是专为解决 agent 间大负载通信设计的协议层工具。其核心机制是将大体积数据（>30字符易触发超时）写入共享文件，仅通过极短的消息指针（CSV格式）在 agent 间传递引用。标准流程包含四个环节：发送方生成 REQ 请求消息、接收方解析并读取文件内容、执行任务后更新结果、发送 CMP 完成确认并验证密钥。
该技能提供四大 CLI 命令：receive 解析 CSV 消息并读取共享文件；update 更新任务执行结果到共享文件；cmp 生成完成确认消息；verify 验证返回的 CMP 消息密钥是否匹配。
显著优点
- 解决核心痛点：直接攻克
sessions_send30字符超时限制，理论上可传输任意大小的结构化数据 - 协议化设计：CSV 格式简洁规范，REQ/CMP 双类型状态机清晰，易于扩展和调试
- 安全机制完善：6位随机密钥实现双向验证，确保接收方真实读取文件而非伪造响应；可选 burn-on-read 实现阅后即焚
- LLM 友好：
AgentRelay:前缀触发模式让 LLM agent 能自动识别并调用，无需人工干预 - 完整工具链：内置测试套件、过期清理、日志追踪、注册表管理，生产就绪度高
潜在局限
- 依赖共享文件系统：要求所有参与 agent 能访问同一存储路径（
~/.openclaw/data/agentrelay/storage/），分布式部署受限 - 无加密传输：共享文件以明文 JSON 存储，依赖文件系统权限保护，高敏感场景需额外加密层
- TTL 管理风险：默认24小时过期，长时间运行任务需显式调整，否则可能文件失效
- 单点故障：共享存储若损坏或不可访问，整个通信链路中断，无内置重试或降级机制
- 协议耦合：强依赖 OpenClaw 生态的文件路径约定，跨平台迁移成本较高
适合人群
- 多 agent 协作场景下需要传输结构化数据（JSON、报告、代码片段等）的开发者
- 遇到
sessions_send频繁超时、需要可靠大负载传输的现有 OpenClaw 用户 - 构建 agent 工作流（如编排-执行分离、主从协作）的系统架构师
- 对消息完整性有验证需求、需要防伪造确认的安全敏感场景
常规风险
- 密钥泄露风险：共享文件中的 secret 若被第三方读取，可伪造 CMP 消息；需配合文件权限严格管控
- 文件残留风险：burn-on-read 未启用时，敏感数据可能在共享存储中残留24小时
- 路径遍历隐患：PTR 字段若未严格校验，可能被利用访问非预期文件（需确认
run_relay.py是否做了路径规范化） - 并发冲突：多接收方同时处理同一 event_id 可能导致结果覆盖，依赖业务层幂等设计
- 日志泄露：transactions 日志以 JSONL 明文记录 event 元数据，可能暴露通信模式
建议
生产部署建议启用 burn_on_read 缩短敏感数据暴露窗口，定期运行 cleanup_relay.py 清理残留，对 PTR 字段做严格的 baseDir 前缀校验，并考虑在高敏感场景叠加文件级加密。