QQ 邮箱监控技能

自动监控 QQ 邮箱新邮件，支持定时检查、语音播报、邮件收发等功能。

📋 功能特性

功能	说明
🔍 新邮件检查	定期检查收件箱，检测新邮件
🔔 实时提醒

发现新邮件时自动通知用户 | | 🔊 TTS 播报 | 语音播报新邮件主题和发件人 | | 📤 发送邮件 | 支持纯文本和 HTML 格式邮件 | | 📎 附件支持 | 可发送带附件的邮件 | | ⏰ 定时任务 | 可配置检查频率（默认 5 分钟） |

🛠️ 工具脚本

1. qqmailauto_check.py - 自动监控脚本

用途： 定时任务专用，检查新邮件并输出通知

使用方法：
bash
python3 scripts/qqmailauto_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. qqmailcheck.py - 手动查看邮件

用途： 查看收件箱邮件列表

使用方法：
bash
python3 scripts/qqmailcheck.py

输出示例：

============================================================
QQ 邮箱检查：289688826@qq.com
============================================================

✅ 登录成功
📊 收件箱共有 90 封邮件

最近 10 封邮件:

1. 1. Mon, 02 Mar 2026 10:32:39 +080

从：QQ 邮箱团队 <10000@qq.com> 主题：更安全、更高效、更强大，尽在 QQ 邮箱 APP ...

3. qqmailsend.py - 发送邮件

用途： 发送测试邮件或自定义邮件

使用方法：
bash
python3 scripts/qqmailsend.py

输出示例：

📤 正在发送邮件...
发件人：289688826@qq.com
收件人：289688826@qq.com
主题：🧪 QQ 邮箱 API 测试邮件

✅ 发送成功！

⚙️ 配置说明

获取授权码

1. 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/
├── qqmailauto_check.py # 自动监控脚本 ⭐
├── qqmailcheck.py # 手动查看脚本
├── qqmailsend.py # 发送邮件脚本
└── qqmailmonitor.py # 监控脚本（备用）

🔔 使用场景

场景	说明
📧 邮件通知	重要邮件实时提醒
🔐 验证码提取

自动读取验证码并播报 | | 📊 日报汇总 | 定时汇总重要邮件 | | 🤖 自动回复 | 根据规则自动回复邮件 | | 📎 附件处理 | 自动下载并保存附件 |

⚠️ 注意事项

1. 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