跳到主要内容

Email 设置

Hermes 可以使用标准 IMAP 和 SMTP 协议接收和回复电子邮件。发送电子邮件到代理地址，它会在线程中回复。

前置要求​

  • 专用电子邮件账户（不要使用个人邮箱）
  • IMAP 启用
  • 应用密码（如果使用 Gmail 且有 2FA）

Gmail 设置​

  1. 在 Google 账户上启用两步验证
  2. 进入 App Passwords 创建应用密码
  3. 使用 16 字符的应用密码而不是常规密码

配置​

hermes gateway setup  # 选择 Email

或手动配置：

EMAIL_ADDRESS=[email protected]
EMAIL_PASSWORD=abcd efgh ijkl mnop  # 应用密码
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_ALLOWED_USERS=[email protected]

工作原理​

  • 接收：轮询 IMAP 收件箱获取新邮件（默认 15 秒间隔）
  • 回复：通过 SMTP 发送，保持邮件线程
  • 附件：缓存本地图像和文档供工具使用

访问控制​

  1. EMAIL_ALLOWED_USERS 设置 → 仅处理这些地址的邮件
  2. 未设置白名单 → 未知发送者收到配对码
  3. EMAIL_ALLOW_ALL_USERS=true → 接受任何发送者
注意

始终配置 EMAIL_ALLOWED_USERS。代理默认具有终端访问权限。

故障排除​

问题解决方案
"IMAP 连接失败"验证 EMAIL_IMAP_HOST 和端口
"SMTP 连接失败"检查密码正确（使用应用密码）
消息未收到检查 EMAIL_ALLOWED_USERS