3.7 邮件接入

平台 第三章：多平台接入

邮件接入概述

通过 IMAP/SMTP 协议接入邮件系统，适合异步通信和正式沟通场景。Hermes 可以自动读取邮件、分析内容、生成回复。

支持的邮件提供商

  • Gmail - 需要应用密码（16 字符）
  • Microsoft Outlook / Office 365 - 支持 IMAP
  • 企业邮箱 - 自建或第三方服务
  • 阿里邮箱、网易邮箱等 - 需启用 IMAP 功能

配置步骤

第一步：获取邮箱凭证

根据邮箱提供商获取 IMAP/SMTP 地址和登录密码。

Gmail 示例

需要开启 2FA，然后生成应用密码（16 字符）。

企业邮箱示例

从企业邮箱管理员获取 IMAP 服务器地址和密码。

第二步：配置环境变量

编辑 ~/.hermes/.env，添加邮箱配置：

# 邮件配置
EMAIL_ADDRESS=your@email.com
EMAIL_PASSWORD=your_app_password

# IMAP 配置（接收邮件）
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_IMAP_PORT=993
EMAIL_IMAP_USE_SSL=true

# SMTP 配置（发送邮件）
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=587
EMAIL_SMTP_USE_TLS=true

第三步：启动网关

hermes gateway setup
# 选择 Email

第四步：验证接入

hermes gateway start
hermes  # 在新终端启动 CLI

适用场景

  • 异步任务处理：接收任务邮件，自动生成回复
  • 客户服务：自动回复常见咨询，分类处理工单
  • 内容审核：Hermes 审阅提交的内容，反馈意见
  • 团队协作：发送项目进展、会议纪要到邮件列表
  • 报告生成：定期生成报告并邮件分发

高级配置

邮件检查频率

在 ~/.hermes/config.yaml 中配置：

email_gateway:
  check_interval: 300  # 每 300 秒检查一次邮件

自动归档已处理邮件

处理完成的邮件可自动移到特定标签或文件夹：

email_gateway:
  archive_label: "Hermes_Processed"  # Gmail 标签
  auto_archive: true

常见问题

邮箱连接失败？

检查清单：

  • IMAP/SMTP 地址和端口是否正确
  • 是否启用了应用密码或授权访问
  • 防火墙是否阻止 IMAP/SMTP 端口（通常 993、587）

邮件无法发送？

检查 SMTP 配置，某些邮箱提供商有额外的限制：

  • Gmail：需要启用"允许不安全的应用"或使用应用密码
  • 企业邮箱：可能需要配置 SPF/DKIM/DMARC 记录

邮件延迟很高？

调整 check_interval 参数，平衡响应速度和资源消耗。建议值：300-600 秒。