qq-mail-monitor

name	qq-mail-monitor
description	QQ 邮箱自动监控技能，支持定时检查新邮件、TTS 语音播报提醒、邮件收发功能。适用于邮件通知、验证码提取、自动回复等场景。

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 安全通知
    发件人：[e-mail]
    时间：03-02 10:35

🔊 TTS: 新邮件提醒。主题：GitHub 安全通知，来自：[e-mail]
[RESULT] NEW_EMAIL|GitHub 安全通知|[e-mail]|03-02 10:35

2. qq_mail_check.py - 手动查看邮件

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

使用方法：

python3 scripts/qq_mail_check.py

输出示例：

============================================================
QQ 邮箱检查：[e-mail]
============================================================

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

最近 10 封邮件:

1. Mon, 02 Mar 2026 10:32:39 +080
   从：QQ 邮箱团队 <[e-mail]>
   主题：更安全、更高效、更强大，尽在 QQ 邮箱 APP
...

3. qq_mail_send.py - 发送邮件

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

使用方法：

python3 scripts/qq_mail_send.py

输出示例：

📤 正在发送邮件...
   发件人：[e-mail]
   收件人：[e-mail]
   主题：🧪 QQ 邮箱 API 测试邮件

✅ 发送成功！

⚙️ 配置说明

获取授权码

1. 登录 QQ 邮箱网页版 (mail.qq.com)
2. 点击 设置 → 账户
3. 找到 POP3/IMAP/SMTP 服务
4. 开启 IMAP/SMTP 服务
5. 点击 生成授权码（需要短信验证）

配置邮箱信息

编辑脚本中的配置区域：

# 配置
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        # 监控脚本（备用）

🔔 使用场景

场景	说明
📧 邮件通知	重要邮件实时提醒
🔐 验证码提取	自动读取验证码并播报
📊 日报汇总	定时汇总重要邮件
🤖 自动回复	根据规则自动回复邮件
📎 附件处理	自动下载并保存附件

⚠️ 注意事项

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