HermesAgent邮箱自动化配置：IMAP协议绑定与自动回复邮件设置

一、验证并配置 IMAP 协议连接

实现 Hermes Agent 邮件自动化的首要步骤，是确保其能够稳定连接至您的邮箱服务器。这一连接完全依赖于 IMAP 协议的正确配置。若连接失败，后续所有自动化流程都将无法启动。常见问题通常源于服务器地址、端口号或身份验证凭据与邮箱服务商的要求不匹配。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

首先，请打开配置文件 ~/.config/himalaya/config.toml，定位到 [backend.imap] 配置区块。您需要仔细核对并填写以下几项关键参数：

1. host（主机地址）：此处必须填写您的邮箱服务商提供的 IMAP 服务器地址。例如，Gmail 用户应填写 imap.gmail.com，而 Outlook/Office 365 用户则应填写 outlook.office365.com，请务必准确区分。

2. port（端口）：为确保安全，推荐使用加密端口 993 (IMAPS)。请确认该端口未被本地防火墙或网络策略阻止。

3. auth.cmd（认证命令）：此命令用于安全获取邮箱密码。请确保该命令指向的脚本或密码管理器路径正确，脚本拥有可执行权限，并且能够准确无误地输出密码。

完成配置修改后，强烈建议立即进行连通性测试。请在终端中执行以下命令：

himalaya --debug list

如果命令成功运行并显示出您邮箱中的邮件列表，则表明 IMAP 连接通道已成功建立。若出现错误提示，请根据错误信息回溯检查上述配置项。

二、创建并绑定自动回复邮件模板

成功建立连接后，下一步是让 Hermes Agent 掌握“如何回复”。这需要您预先创建一份邮件回复模板。自动回复功能的本质，就是在特定事件被触发时，系统调用此模板生成标准化的回复内容并自动发送。

具体操作步骤如下：

1. 登录 Hermes Agent 的管理后台，导航至“通知模板”或类似的管理页面，点击“创建新模板”。

2. 在模板类型中，务必选择“邮件”或“Email”。随后，在正文编辑区域撰写您的自动回复内容，例如：“您好！您的来信已收到，我会尽快查阅并处理。”——此内容将作为自动回复的基准范本。

3. 保存模板后，系统会自动生成一个唯一的 模板ID（格式通常为 tmpl_8a3f9b2e 等）。请复制保存此 ID。

4. 最后，打开 Hermes Agent 的环境变量配置文件 ~/.hermes/.env，在其中新增一行配置：

AUTO_REPLY_TEMPLATE_ID=tmpl_8a3f9b2e

通过此设置，Hermes Agent 便明确了在需要自动回复时应调用哪一个模板。

三、启用 Hermes 邮件事件监听与自动回复逻辑

至此，Agent 已具备收信能力和回复模板，但仍需要一个“触发器”来启动自动化流程。默认情况下，邮件事件监听功能处于关闭状态，您需要手动启用它，并精确设定触发自动回复的条件。

1. 打开 Hermes Agent 的主配置文件（通常位于 ~/.hermes/config.yaml），找到 notifications → email 配置段落。

2. 将 enabled 参数的值设置为 true。同时，检查 events 列表，确保其中包含了您需要监听的关键事件，例如 new_email_received（收到新邮件）和 email_keyword_matched（邮件命中关键词）。

3. 仅开启监听还不够，必须定义具体的回复规则。请在 skills/email/ 目录下，创建一个新的规则文件（如 auto_reply.md）。在该文件中，使用条件语句定义触发逻辑。例如，您可以设定规则为：“当邮件发件人域名不在白名单内，且邮件主题包含‘紧急’或‘咨询’关键词时，自动发送回复模板。”

4. 完成所有配置后，请务必重启 Hermes Agent 服务，以使所有更改生效：

hermes gateway restart

四、使用 Himalaya CLI 手动触发测试回复

在完全投入自动化运行之前，强烈建议先进行一次手动端到端测试。这能有效验证从模板渲染到邮件发送的整个链路是否完全通畅，避免因配置错误导致自动化静默失效。

测试方法非常简便，直接使用 Himalaya 命令行工具即可：

himalaya compose --to test@example.com --template-id tmpl_8a3f9b2e --send

请务必将 test@example.com 替换为您能实时查看的邮箱地址，并将 tmpl_8a3f9b2e 替换为您在第二步中获取的真实模板ID。

执行命令后，请立即登录目标邮箱查收。如果短时间内收到了与模板内容一致的回复邮件，则表明测试成功。若未收到邮件，请不必担心，可查看 Hermes 的日志文件 ~/.hermes/logs/email.log 进行排查。请重点关注最新的 ERROR 级别日志，其中如“template render failed”（模板渲染失败）、“smtp auth rejected”（SMTP认证被拒）等错误信息，能为您提供明确的故障定位方向。

五、校验多邮箱账户时区与时间戳一致性

此问题常被忽视，但一旦发生可能导致严重混乱。当您使用同一个 Hermes Agent 管理多个位于不同地理时区的邮箱账户时，若时区设置不统一，自动回复可能会在非预期的时间触发，或产生不可预知的延迟。

1. 统一配置时区：您需要在每个邮箱账户的配置中明确指定其所属时区。编辑 ~/.config/himalaya/config.toml 文件，为每一个独立的 [account] 配置区块添加 timezone 字段。例如：timezone = “Asia/Shanghai”。

2. 测试时间同步：配置完成后，建议分别测试每个账户的邮件拉取时间是否准确。运行以下命令：

himalaya --account=work list --limit=1
himalaya --account=personal list --limit=1

对比各命令输出结果中邮件的 Date 字段，检查它们与您当前系统时间的偏差是否控制在一分钟以内。

3. 同步系统时钟：如果发现所有账户的时间都存在显著偏差，问题可能源于服务器系统时钟不准。您可以尝试同步网络时间：

sudo timedatectl set-ntp true

时间同步完成后，请记得重启 himalaya 相关服务进程，以确保配置生效。