Hermes Agent Webhook 收不到事件,先确认外部服务能访问你的回调地址,再看签名、路径、端口和网关日志。Webhook 问题不要先怀疑 Agent 智能,第一层通常就是 HTTP 请求没打到 Hermes。
先验证请求有没有进来
用 hermes logs 或网关日志观察是否有请求记录。如果没有记录,说明问题在域名、端口、防火墙、反向代理或内网穿透。你需要先让外部平台能访问到 Hermes 暴露的 webhook endpoint。
再查平台配置
- 回调 URL 是否写完整,包括协议、路径和端口。
- 平台是否要求 HTTPS,证书是否有效。
- 签名 secret 是否和 Hermes 配置一致。
- 事件类型是否勾选,例如 push、issue、comment、release。
收到请求但没有动作怎么办
如果日志能看到请求,但 Hermes 没有回复或没触发任务,检查订阅规则、目标平台、目标会话和权限。Webhook 只是“叫醒”入口,后面还要知道把事件交给哪个 Agent、哪个会话、用什么工具处理。
建议先用最小事件测试,比如发送一个测试 payload,让 Hermes 只回复“收到”。确认链路通了,再让它执行复杂自动化。这样能把网络问题、签名问题和 Agent 逻辑问题分开。