HermesAgent邮箱自动化配置：IMAP协议绑定与自动回复邮件设置
一、验证并配置 IMAP 协议连接
实现 Hermes Agent 邮件自动化的首要前提，是建立可靠的 IMAP 连接。这是所有后续邮件处理逻辑的基础。连接失败通常源于服务器地址、端口或认证凭据与邮箱服务商的要求不匹配。
首先，编辑配置文件 ~/.config/himalaya/config.toml，定位到 [backend.imap] 部分。请逐项核对以下关键参数：
1. host：填写你的邮箱服务商提供的 IMAP 服务器地址。例如，Gmail 为 imap.gmail.com，Outlook 为 outlook.office365.com。务必确保地址准确无误。
2. port：标准加密端口为 993 (IMAPS)。请确认端口开放，且未被本地防火墙或安全策略阻止。
3. auth.cmd：此命令用于动态获取邮箱密码。请验证其指向的脚本路径有效，具备可执行权限，并能稳定输出正确的密码字符串。
完成配置后，务必进行连接测试。在终端执行：
himalaya --debug list
若命令成功执行并返回邮箱邮件列表，则表明 IMAP 连接已就绪。若出现错误，请根据终端输出的错误信息，回溯检查上述配置项。
二、创建并绑定自动回复邮件模板
建立连接后，需定义 Hermes Agent 的回复内容。这通过创建邮件模板实现。自动回复功能在触发时，会调用指定模板生成邮件正文并发送。
具体操作步骤如下：
1. 登录 Hermes 管理后台，进入通知模板管理界面，点击“新建模板”。
2. 模板类型选择“邮件”，在正文编辑区撰写你的标准回复内容，例如：“您好，邮件已收到，我们将在24小时内处理您的请求。”此内容将作为自动回复的基准。
3. 保存模板后，系统会分配一个唯一的 模板ID（格式如 tmpl_8a3f9b2e）。请复制此 ID。
4. 最后，编辑环境变量文件 ~/.hermes/.env，添加配置行：
AUTO_REPLY_TEMPLATE_ID=tmpl_8a3f9b2e
此操作将模板与 Hermes Agent 的自动回复逻辑关联起来。
三、启用 Hermes 邮件事件监听与自动回复逻辑
此时，Agent 具备了连接能力和回复内容，但需要激活监听器作为触发器。邮件事件监听默认关闭，需手动启用并配置触发条件。
1. 打开 Hermes 主配置文件（通常为 ~/.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 authentication failed”（SMTP认证失败）将指明排查方向。
五、校验多邮箱账户时区与时间戳一致性
此问题在管理跨时区邮箱账户时尤为关键。时区设置不一致可能导致自动回复触发时机错乱、邮件处理延迟或时间戳解析错误。
1. 为每个邮箱账户明确配置时区。编辑 ~/.config/himalaya/config.toml，在每个独立的 [account] 区块内添加 timezone 字段，例如：timezone = “Asia/Shanghai”。
2. 配置后，分别测试各账户的邮件同步时间是否准确。运行：
himalaya --account=work list --limit=1
himalaya --account=personal list --limit=1
对比输出中邮件的 Date 字段，检查其与服务器本地时间的偏差是否在可接受范围内（通常小于1分钟）。
3. 若所有账户时间均存在显著系统性偏差，可能是宿主机系统时钟不同步。可尝试同步网络时间：
sudo timedatectl set-ntp true
时间同步完成后，请重启 himalaya 相关服务进程。