SuperAPI AI 工具集

email-manager

办公与效率

查看项目

更新于 10-15 10:22

技能介绍

Email Manager 是一个邮箱智能管家技能,用于统一管理多个邮箱账号并提供 AI 辅助的邮件处理能力。

【用途】 适用于需要同时管理多个邮箱账号(如 Gmail、QQ、Outlook 等)的场景,可定时查看邮件并生成摘要,智能生成回复草稿(需确认后发送),以及对重要邮件进行即时提醒。

【主要能力】

  1. 多账号管理:支持任意 IMAP 邮箱,使用 pass 安全存储凭据,配置文件为 config/accounts.json。
  2. 定时任务:每日 8:00 和 17:00 自动检查,通过 OpenClaw cron 调度,发现重要邮件即时通知。
  3. 智能摘要:使用 AI 提取邮件要点,按优先级分类,推送到 WhatsApp/Telegram。
  4. 安全发送:AI 生成回复草稿,发送前展示预览,用户确认后才发送。

【使用方式】 触发词包括“查看邮件”“邮件摘要”“回复邮件”“添加邮箱账号”“邮件设置”。

配置步骤:

  1. 添加邮箱账号,使用 pass 存储凭据。Gmail 需先开启 IMAP 并生成应用专用密码;QQ 邮箱需先开启 IMAP 服务并获取授权码。
  2. 更新账号配置,编辑 config/accounts.json,填写账号名称、邮箱、服务商、IMAP/SMTP 服务器与端口、启用状态等。
  3. 设置定时任务,使用 OpenClaw cron 添加早间(0 8 * * *)和晚间(0 17 * * *)邮件检查任务,执行 scripts/check_email.py。

【安全策略】 读取邮件列表、读取邮件内容、生成摘要、创建回复草稿均为自动执行;发送邮件需用户确认;删除邮件被禁止。

【相关文件】 scripts/check_email.py(邮件检查与摘要)、scripts/send_email.py(发送邮件,需确认)、scripts/reply_draft.py(生成回复草稿)、config/accounts.json(账号配置)、config/providers.json(邮件服务商配置)。

【常见邮箱 IMAP 配置】 Gmail:imap.gmail.com,端口 993;QQ 邮箱:imap.qq.com,端口 993;Outlook:outlook.office365.com,端口 993;163 邮箱:imap.163.com,端口 993;126 邮箱:imap.126.com,端口 993。

【使用示例】 查看邮件摘要:用户输入“查看邮件”,AI 读取所有配置邮箱并生成摘要,按邮箱列出未读邮件及重要标记。 回复邮件:用户输入“回复第1封邮件,告诉他项目进度正常”,AI 生成回复草稿并展示收件人、主题、内容,询问是否确认发送(回复“确认”发送,“修改”调整,“取消”放弃)。

【故障排查】 SSL/连接问题:症状为 Connection reset by peer、SSL: UNEXPECTED_EOF_WHILE_READING,根因是 Mihomo/Clash TUN 模式劫持 IMAP 长连接不稳定。解决方式:Gmail 等海外邮箱在 Mihomo Merge.yaml 添加 DOMAIN-SUFFIX,imap.gmail.com,DIRECT;QQ/163 等国内邮箱需走国内代理出口,不可直连(海外 VPS)。代码已内置 ssl_context + 3次重试 + 2s退避。 编码问题:症状为 LookupError: unknown encoding: unknown-8bit,解决方式为 _parse_email 已添加 try/except 兜底用 utf-8 解码。 超时问题:症状为 check_email.py 被 SIGKILL,解决方式为跳过 test_connection、limit 降到 10、使用 headers_only=True。

创建日期:2026-02-19;更新日期:2026-02-24;版本:1.1.0。