邮件接入——让 AI 收发邮件 | Easy Understand Hermes Agent

这篇教程教你如何给 Hermes Agent 配一个专属邮箱，让它能自己收信、回信，就像一个 24 小时在线的邮件助理。

准备工作：给 AI 办一张“电话卡”

想象一下，你要给 AI 配一部专用手机。我们得先准备三样东西：

一个全新的邮箱账号（千万别用你个人的主力邮箱，原因后面说）
开启 IMAP 功能（相当于允许手机 App 读取邮件）
一个“应用专用密码”（不是你的登录密码，而是给第三方软件用的临时钥匙）

如果你用 Gmail：先去 Google 账户开启两步验证，然后到 App Passwords 页面生成一个 16 位密码。这个密码长这样：abcd efgh ijkl mnop，记下来备用。

如果你用 Outlook / 微软邮箱：去安全设置开启两步验证，然后在“其他安全选项”里创建应用密码。IMAP 服务器是 outlook.office365.com，SMTP 服务器是 smtp.office365.com。

其他邮箱：去官网查一下 IMAP 和 SMTP 地址就行，一般 IMAP 用 993 端口（SSL 加密），SMTP 用 587 端口（STARTTLS 加密）。

第 1 步：告诉 Hermes 邮箱的“住址”和“钥匙”

打开终端，运行：

hermes gateway setup

在菜单中选择 Email，然后按照提示输入邮箱地址、应用密码、IMAP/SMTP 服务器地址。就这么简单。

如果你想手动配置，打开 ~/.hermes/.env 文件，添加以下内容：

# 必填
EMAIL_ADDRESS=hermes@gmail.com
EMAIL_PASSWORD=abcd efgh ijkl mnop    # 用应用密码，不是登录密码！
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com

# 安全设置（强烈推荐）
EMAIL_ALLOWED_USERS=your@email.com,colleague@work.com

EMAIL_ALLOWED_USERS 就是“白名单”——只有名单里的人发邮件，AI 才会回复。其他人发来的邮件会被静默忽略，就像设置了“仅限联系人”一样。

第 2 步：启动邮件网关

hermes gateway              # 前台运行
hermes gateway install      # 安装为后台服务，开机自启

启动时，Hermes 会做三件事：测试邮件连接、把收件箱里已有的邮件标记为“已读”（只处理新邮件）、然后开始每 15 秒检查一次新邮件。

AI 是怎么工作的？

收信时，AI 会看邮件主题、提取正文、把图片附件缓存下来（这样它能“看”图），并自动忽略垃圾邮件和自动回复（比如 noreply@ 开头的地址）。

回信时，AI 通过 SMTP 发信，自动带上 Re: 前缀，并保留邮件线程——就像微信里“引用回复”一样，对方能看出是接着哪封邮件回的。

想发附件？ 在 AI 的回复里加上 MEDIA:/path/to/file，文件就会自动附在邮件里。

安全提醒（重要！）

务必使用专用邮箱。因为 Hermes 会把密码存在 ~/.hermes/.env 文件里，并且有整个收件箱的读取权限。这就像把家门钥匙交给了管家——你得确保这个管家只服务你一个人。

另外，建议把 .env 文件权限设为 chmod 600，只有你自己能读。

常见问题速查

问题	解决办法
启动报“IMAP connection failed”	检查 IMAP 地址和端口，确认邮箱已开启 IMAP
收不到邮件	看看是不是发件人不在白名单里，或者被丢进垃圾箱了
提示“Authentication failed”	Gmail 必须用应用密码，不能用登录密码
回复太慢	默认 15 秒检查一次，可以调成 `EMAIL_POLL_INTERVAL=5`

总结一下：给 AI 配邮箱，核心就是三步——准备专用邮箱和应用密码、配置 Hermes、启动网关。配好之后，你就拥有一个能自动收发邮件的 AI 助理了。

下篇预告：邮件搞定后，我们再来聊聊怎么让 AI 接入钉钉——在办公场景里直接 @ 它干活，敬请期待！