立项背景:Hermes与OpenClaw两个AI Agent之间需要通过A2A(Agent-to-Agent)协议双向通信,但现有网关存在三个生产问题:tasks/send请求挂起长达5分钟、未带token时返回500、inbox消息写不进去,导致跨Agent通信不可用。目标:修复网关故障,打通Hermes到OpenClaw的双向通信。功能模块:A2A JSON-RPC网关——tasks/send消息发送、tasks/get任务状态查询、authMiddleware鉴权拦截、inbox消息落地。业务流程:Hermes通过HTTP POST发起JSON-RPC请求,网关经Bearer Token鉴权后写入inbox并即时返回,消息经Watcher轮询触发飞书通知送达OpenClaw。
整体架构:基于OpenClaw Gateway的A2A JSON-RPC端点,采用HTTP/JSON-RPC 2.0协议,Bearer Token鉴权中间件+inbox落地+定时Watcher消费,组成完整双向消息通道。负责模块与结果:独立定位并修复三个生产缺陷——①tasks/send挂起5分钟:根因WebSocket自连接超时,改为直接写inbox+即时ack,响应降至37ms;②无token返回500:根因A2AError instanceof跨模块失效,用authMiddleware提前拦截;③inbox写不进:根因环境变量不可靠,改用import.meta.url相对路径定位。难点与解决:跨模块错误类型判断失效导致鉴权异常,通过中间件前置拦截修复;环境变量在打包后不一致,采用运行时相对路径定位存储目录。