Email Manager - 邮箱智能管家

当使用此技能

• 管理多个邮箱账号（Gmail、QQ、Outlook 等）
• 定时查看邮件并生成摘要
• 智能生成回复草稿（需确认后发送）
• 重要邮件即时提醒

核心功能

1. 多账号管理

• 支持任意 IMAP 邮箱
• 使用 pass 安全存储凭据
• 配置文件：config/accounts.json

2. 定时任务

• 每日 8:00 和 17:00 自动检查
• 通过 OpenClaw cron 调度
• 发现重要邮件即时通知

3. 智能摘要

• 使用 AI 提取邮件要点
• 按优先级分类
• 推送到 WhatsApp/Telegram

4. 安全发送

• AI 生成回复草稿
• 发送前展示预览
• 用户确认后才发送

触发词

• "查看邮件"
• "邮件摘要"
• "回复邮件"
• "添加邮箱账号"
• "邮件设置"

配置步骤

1. 添加邮箱账号

# Gmail（需先开启 IMAP 并生成应用专用密码）
pass insert email/gmail/your-email@gmail.com
pass insert email/gmail/your-email@gmail.com-app-pass

# QQ 邮箱（需先开启 IMAP 服务并获取授权码）
pass insert email/qq/your-qq@qq.com
pass insert email/qq/your-qq@qq.com-auth-code

2. 更新账号配置

编辑 config/accounts.json：

{
  "accounts": [
    {
      "name": "Gmail 主邮箱",
      "email": "your-email@gmail.com",
      "provider": "gmail",
      "imap_server": "imap.gmail.com",
      "imap_port": 993,
      "smtp_server": "smtp.gmail.com",
      "smtp_port": 587,
      "enabled": true
    },
    {
      "name": "QQ 邮箱",
      "email": "your-qq@qq.com",
      "provider": "qq",
      "imap_server": "imap.qq.com",
      "imap_port": 993,
      "smtp_server": "smtp.qq.com",
      "smtp_port": 587,
      "enabled": true
    }
  ]
}

3. 设置定时任务

使用 OpenClaw cron：

# 8:00 检查邮件
openclaw cron add --name "早间邮件检查" --schedule "0 8 * * *" --script "~/clawd/skills/email-manager/scripts/check_email.py"

# 17:00 检查邮件
openclaw cron add --name "晚间邮件检查" --schedule "0 17 * * *" --script "~/clawd/skills/email-manager/scripts/check_email.py"

安全策略

操作	权限级别
读取邮件列表	🟢 自动
读取邮件内容	🟢 自动
生成摘要	🟢 自动
创建回复草稿	🟢 自动
发送邮件	🟡 需确认
删除邮件	🔴 禁止

相关文件

• scripts/check_email.py - 邮件检查与摘要
• scripts/send_email.py - 发送邮件（需确认）
• scripts/reply_draft.py - 生成回复草稿
• config/accounts.json - 账号配置
• config/providers.json - 邮件服务商配置

常见邮箱 IMAP 配置

邮箱	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: [读取所有配置邮箱，生成摘要]
    
    📧 今日邮件摘要 (2026-02-19 08:00)
    
    Gmail 主邮箱 (3 封未读):
    1. [重要] 项目进度更新 - 张三
    2. 会议邀请：周五例会 - 李四
    3. 订单发货通知 - 淘宝
    
    QQ 邮箱 (1 封未读):
    1. 验证码通知 - 某服务

回复邮件

用户: 回复第1封邮件，告诉他项目进度正常
AI: [生成回复草稿]

    📝 回复草稿：
    
    收件人: 张三 <zhangsan@example.com>
    主题: Re: 项目进度更新
    
    内容:
    ---
    张三，你好！
    
    感谢你的关注。项目进度一切正常，目前按计划推进中。
    
    如有其他问题，随时联系。
    
    祝好，
    Daniel
    ---
    
    确认发送吗？（回复"确认"发送，"修改"调整，"取消"放弃）

---

故障排查

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