qq-mail-monitor

# QQ 邮箱监控技能 自动监控 QQ 邮箱新邮件，支持定时检查、语音播报、邮件收发等功能。 ## 📋 功能特性 | 功能 | 说明 | |------|------| | 🔍 新邮件检查 | 定期检查收件箱，检测新邮件 | | 🔔 实时提醒 | 发现新邮件时自动通知用户 | | 🔊 TTS 播报 | 语音播报新邮件主题和发件人 | | 📤 发送邮件 | 支持纯文本和 HTML 格式邮件 | | 📎 附件支持 | 可发送带附件的邮件 | | ⏰ 定时任务 | 可配置检查频率（默认 5 分钟） | ## 🛠️ 工具脚本 ### 1. qq_mail_auto_check.py - 自动监控脚本 **用途：** 定时任务专用，检查新邮件并输出通知 **使用方法：** ```bash python3 scripts/qq_mail_auto_check.py ``` **输出示例：** ``` [2026-03-02 10:40:48] 🔍 检查 QQ 邮箱新邮件... [!] 📬 发现新邮件！ 主题：GitHub 安全通知 发件人：noreply@github.com 时间：03-02 10:35 🔊 TTS: 新邮件提醒。主题：GitHub 安全通知，来自：noreply@github.com [RESULT] NEW_EMAIL|GitHub 安全通知|noreply@github.com|03-02 10:35 ``` ### 2. qq_mail_check.py - 手动查看邮件 **用途：** 查看收件箱邮件列表 **使用方法：** ```bash python3 scripts/qq_mail_check.py ``` **输出示例：** ``` ============================================================ QQ 邮箱检查：289688826@qq.com ============================================================ ✅ 登录成功 📊 收件箱共有 90 封邮件 最近 10 封邮件: 1. Mon, 02 Mar 2026 10:32:39 +080 从：QQ 邮箱团队 <10000@qq.com> 主题：更安全、更高效、更强大，尽在 QQ 邮箱 APP ... ``` ### 3. qq_mail_send.py - 发送邮件 **用途：** 发送测试邮件或自定义邮件 **使用方法：** ```bash python3 scripts/qq_mail_send.py ``` **输出示例：** ``` 📤 正在发送邮件... 发件人：289688826@qq.com 收件人：289688826@qq.com 主题：🧪 QQ 邮箱 API 测试邮件 ✅ 发送成功！ ``` ## ⚙️ 配置说明 ### 获取授权码 1. 登录 QQ 邮箱网页版 (mail.qq.com) 2. 点击 **设置** → **账户** 3. 找到 **POP3/IMAP/SMTP 服务** 4. 开启 **IMAP/SMTP 服务** 5. 点击 **生成授权码**（需要短信验证） ### 配置邮箱信息 编辑脚本中的配置区域： ```python # 配置 EMAIL = "你的 QQ 号@qq.com" AUTH_CODE = "你的授权码" # 16 位字符串，不是登录密码 IMAP_SERVER = "imap.qq.com" IMAP_PORT = 993 SMTP_SERVER = "smtp.qq.com" SMTP_PORT = 465 ``` ## ⏰ 定时任务配置 ### 查看当前任务 ```bash cron list ``` ### 修改检查频率 告诉助手："改成每 X 分钟检查邮件" ### 暂停/恢复监控 - 暂停："暂停邮件监控" - 恢复："恢复邮件监控" ### 立即检查 告诉助手："现在检查邮件" ## 📁 文件结构 ``` qq-mail-monitor/ ├── SKILL.md # 技能说明文档 ├── README.md # 使用文档 ├── _meta.json # 元数据 ├── .clawhub/ │ └── origin.json # ClawHub 注册信息 └── scripts/ ├── qq_mail_auto_check.py # 自动监控脚本 ⭐ ├── qq_mail_check.py # 手动查看脚本 ├── qq_mail_send.py # 发送邮件脚本 └── qq_mail_monitor.py # 监控脚本（备用） ``` ## 🔔 使用场景 | 场景 | 说明 | |------|------| | 📧 邮件通知 | 重要邮件实时提醒 | | 🔐 验证码提取 | 自动读取验证码并播报 | | 📊 日报汇总 | 定时汇总重要邮件 | | 🤖 自动回复 | 根据规则自动回复邮件 | | 📎 附件处理 | 自动下载并保存附件 | ## ⚠️ 注意事项 1. **授权码安全**：授权码不是登录密码，不要泄露 2. **检查频率**：建议不低于 5 分钟，避免触发 QQ 邮箱风控 3. **网络环境**：确保网络可访问 imap.qq.com 和 smtp.qq.com 4. **状态文件**：`.mail_state.json` 记录已检查的邮件，不要删除 ## 🆘 常见问题 **Q: 连接失败怎么办？** A: 检查授权码是否正确，确保已开启 IMAP/SMTP 服务 **Q: 收不到提醒？** A: 检查 cron 任务是否启用，查看任务日志 **Q: 如何修改提醒方式？** A: 告诉助手"修改邮件提醒方式"，可调整为消息/TTS/两者 --- **版本：** 1.0.0 **作者：** OpenClaw **更新时间：** 2026-03-02