若Hermes Agent邮箱自动化异常，需依次验证IMAP连接（检查config.toml中host/port/auth.cmd并用himalaya --debug list测试）、绑定邮件模板（新建模板并配置AUTO_REPLY_TEMPLATE_ID环境变量）、启用email事件监听（在config.yaml中设置notifications.email.enabled=true及对应events）、手动测试发送（himalaya compose --send），并校准时区一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 Hermes Agent 并希望实现邮箱自动化处理，但无法通过 IMAP 协议正常连接邮箱或自动回复功能未触发，则可能是由于 IMAP 凭据配置错误、邮件模板未绑定或事件监听未启用。以下是解决此问题的步骤：
一、验证并配置 IMAP 协议连接
IMAP 是 Hermes Agent 读取和管理邮箱的基础协议，正确配置可确保其持续拉取新邮件并识别待处理任务。需确认服务器地址、端口、认证方式与凭据均与邮箱服务商要求一致。
1、打开 ~/.config/himalaya/config.toml 文件，检查 [backend.imap] 区块是否完整填写。
2、确认 host 值为对应邮箱服务商的 IMAP 地址，例如 Gmail 使用 imap.gmail.com，Outlook 使用 outlook.office365.com。
3、确认 port 值为 993（IMAPS 加密端口），且 auth.cmd 调用的密码存储路径存在且可执行。
4、运行测试命令验证连通性：himalaya --debug list，若返回邮件列表则表示 IMAP 连接成功。
二、创建并绑定自动回复邮件模板
自动回复依赖预定义的邮件模板 ID，Hermes Agent 在匹配特定触发条件（如新收件、关键词命中）时调用该模板生成响应内容。模板必须在通知系统中注册并启用。
1、进入 Hermes 的通知模板管理界面，点击“新建模板”，选择“邮件类型”。
2、在正文区域填写自动回复文本，例如：“您好，您的邮件已收到，我将在24小时内回复。”
3、保存后，在模板列表中复制该条目的 模板ID（格式类似 tmpl_8a3f9b2e）。
4、编辑 ~/.hermes/.env 文件，添加变量：AUTO_REPLY_TEMPLATE_ID=tmpl_8a3f9b2e。
三、启用 Hermes 邮件事件监听与自动回复逻辑
Hermes Agent 默认不主动监听邮件事件，需显式启用 email channel 的事件驱动能力，并配置触发规则，否则即使 IMAP 连通且模板就位，也不会执行自动回复。
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 发送预设模板邮件，用于验证模板渲染、收件人解析及 SMTP 发送链路是否通畅。
1、执行命令：himalaya compose --to test@example.com --template-id tmpl_8a3f9b2e --send。
2、检查目标邮箱是否在 10 秒内收到自动回复邮件。
3、若失败，查看 ~/.hermes/logs/email.log 中最近三条 ERROR 日志，重点关注 template render failed 或 smtp auth rejected 字样。
五、校验多邮箱账户时区与时间戳一致性
当 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 字段是否与系统当前时间偏差超过 1 分钟。
3、若偏差显著，同步系统时钟：sudo timedatectl set-ntp true，并重启 himalaya 服务。
