Hermes Agent Email 场景里,“能发不能收”和“收到了不回”通常不是同一类错。前者多半是 IMAP 没开或密码不对,后者更常见的是 EMAIL_ALLOWED_USERS 没放行。官方 Email 文档的排查顺序其实很清楚:先查 IMAP/SMTP,再查 App Password,最后查允许名单。
最短排查顺序
- Gmail 或 Outlook 用 2FA 时,
EMAIL_PASSWORD要填 App Password,不是登录密码。 - 确认 IMAP host / SMTP host 对应邮箱服务商,IMAP 常见是 993,SMTP 常见是 587。
- 如果完全收不到新信,先检查 IMAP 是否在邮箱后台启用。
- 如果能看到邮件但 Hermes 不处理,查
EMAIL_ALLOWED_USERS是否包含发件人地址。
为什么会“收到了却不回”
Hermes 会过滤自发邮件、noreply、bulk 和一些自动化邮件头,避免邮件回环。所以不是所有进入收件箱的邮件都会触发回复。另外,如果你同时跑了两个 gateway,也可能出现重复回复或状态混乱。
结论很直接:认证错,查 App Password;收信错,查 IMAP;不回复,查 allowed users 和过滤规则。别把这三件事混成一个“邮件坏了”。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。