词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"电子邮件"
电子邮件设置
无外部依赖
imaplib、smtplib 和 email 模块，无需额外安装软件包或外部服务。前提条件
Gmail 设置
Outlook / Microsoft 365
1.
2.
3.
4.
outlook.office365.com，SMTP 主机：smtp.office365.com其他服务商
第一步：配置 Hermes
手动配置
~/.hermes/.env 中添加：第二步：启动 Gateway
1.
2.
3.
工作原理
接收邮件
[Subject: Deploy to production]）Re: 开头）跳过主题前缀——线程上下文已经建立noreply@、mailer-daemon@、bounce@、no-reply@，以及包含 Auto-Submitted、Precedence: bulk 或 List-Unsubscribe 头部的邮件发送回复
Re: 前缀（不会出现 Re: Re: 重复）文件附件
MEDIA:/path/to/file，该文件将作为附件添加到发出的邮件中。跳过附件
config.yaml 中添加：访问控制
1.
EMAIL_ALLOWED_USERS → 仅处理来自这些地址的邮件2.
3.
EMAIL_ALLOW_ALL_USERS=true → 接受任意发件人（请谨慎使用）警告
EMAIL_ALLOWED_USERS。 若不配置，任何知道 Agent 邮箱地址的人都可以发送命令。Agent 默认具有终端访问权限。故障排查
| 问题 | 解决方案 |
|---|---|
| 启动时出现 "IMAP connection failed" | 检查 EMAIL_IMAP_HOST 和 EMAIL_IMAP_PORT。确保账户已启用 IMAP。对于 Gmail，在设置 → 转发和 POP/IMAP 中启用。 |
| 启动时出现 "SMTP connection failed" | 检查 EMAIL_SMTP_HOST 和 EMAIL_SMTP_PORT。确认密码正确（Gmail 请使用应用专用密码）。 |
| 未收到邮件 | 检查 EMAIL_ALLOWED_USERS 是否包含发件人邮箱。检查垃圾邮件文件夹——部分服务商会将自动回复标记为垃圾邮件。 |
| "Authentication failed" | 对于 Gmail，必须使用应用专用密码，而非常规密码。请先确保已启用双重验证。 |
| 重复回复 | 确保只有一个 gateway 实例在运行。检查 hermes gateway status。 |
| 响应缓慢 | 默认轮询间隔为 15 秒。设置 EMAIL_POLL_INTERVAL=5 可加快响应速度（但会增加 IMAP 连接次数）。 |
| 回复未归入线程 | 适配器使用 In-Reply-To 头部。部分邮件客户端（尤其是网页版）可能无法正确将自动回复归入线程。 |
安全
警告
.env 文件中，并通过 IMAP 拥有完整的收件箱访问权限。EMAIL_ALLOWED_USERS 以限制可与 Agent 交互的用户~/.hermes/.env 中——请保护此文件（chmod 600）环境变量参考
| 变量 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
EMAIL_ADDRESS | 是 | — | Agent 的邮箱地址 |
EMAIL_PASSWORD | 是 | — | 邮箱密码或应用专用密码 |
EMAIL_IMAP_HOST | 是 | — | IMAP 服务器主机（例如 imap.gmail.com） |
EMAIL_SMTP_HOST | 是 | — | SMTP 服务器主机（例如 smtp.gmail.com） |
EMAIL_IMAP_PORT | 否 | 993 | IMAP 服务器端口 |
EMAIL_SMTP_PORT | 否 | 587 | SMTP 服务器端口 |
EMAIL_POLL_INTERVAL | 否 | 15 | 收件箱检查间隔（秒） |
EMAIL_ALLOWED_USERS | 否 | — | 允许的发件人地址，逗号分隔 |
EMAIL_HOME_ADDRESS | 否 | — | cron 任务的默认投递目标 |
EMAIL_ALLOW_ALL_USERS | 否 | false | 允许所有发件人（不推荐） |
修改于 2026-05-31 00:25:01