QQ 邮箱监控技能
自动监控 QQ 邮箱新邮件，支持定时检查、语音播报、邮件收发等功能。
📋 功能特性
| 功能 | 说明 |
|---|---|
| 🔍 新邮件检查 | 定期检查收件箱，检测新邮件 |
| 🔔 实时提醒 | 发现新邮件时自动通知用户 |
| 🔊 TTS 播报 | 语音播报新邮件主题和发件人 |
| 📤 发送邮件 | 支持纯文本和 HTML 格式邮件 |
| 📎 附件支持 | 可发送带附件的邮件 |
| ⏰ 定时任务 | 可配置检查频率（默认 5 分钟） |
🛠️ 工具脚本
1. qq_mail_auto_check.py - 自动监控脚本
用途： 定时任务专用，检查新邮件并输出通知
使用方法：
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 - 手动查看邮件
用途： 查看收件箱邮件列表
使用方法：
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 - 发送邮件
用途： 发送测试邮件或自定义邮件
使用方法：
python3 scripts/qq_mail_send.py
输出示例：
📤 正在发送邮件...
发件人：289688826@qq.com
收件人：289688826@qq.com
主题：🧪 QQ 邮箱 API 测试邮件
✅ 发送成功！
⚙️ 配置说明
获取授权码
- 登录 QQ 邮箱网页版 (mail.qq.com)
- 点击 设置 → 账户
- 找到 POP3/IMAP/SMTP 服务
- 开启 IMAP/SMTP 服务
- 点击 生成授权码（需要短信验证）
配置邮箱信息
编辑脚本中的配置区域：
# 配置
EMAIL = "你的 QQ 号@qq.com"
AUTH_CODE = "你的授权码" # 16 位字符串，不是登录密码
IMAP_SERVER = "imap.qq.com"
IMAP_PORT = 993
SMTP_SERVER = "smtp.qq.com"
SMTP_PORT = 465
⏰ 定时任务配置
查看当前任务
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 # 监控脚本（备用）
🔔 使用场景
| 场景 | 说明 |
|---|---|
| 📧 邮件通知 | 重要邮件实时提醒 |
| 🔐 验证码提取 | 自动读取验证码并播报 |
| 📊 日报汇总 | 定时汇总重要邮件 |
| 🤖 自动回复 | 根据规则自动回复邮件 |
| 📎 附件处理 | 自动下载并保存附件 |
⚠️ 注意事项
- 授权码安全：授权码不是登录密码，不要泄露
- 检查频率：建议不低于 5 分钟，避免触发 QQ 邮箱风控
- 网络环境：确保网络可访问 imap.qq.com 和 smtp.qq.com
- 状态文件：
.mail_state.json记录已检查的邮件，不要删除
🆘 常见问题
Q: 连接失败怎么办？ A: 检查授权码是否正确，确保已开启 IMAP/SMTP 服务
Q: 收不到提醒？ A: 检查 cron 任务是否启用，查看任务日志
Q: 如何修改提醒方式？ A: 告诉助手"修改邮件提醒方式"，可调整为消息/TTS/两者
版本： 1.0.0
作者： OpenClaw
更新时间： 2026-03-02