- 多邮箱监控 — 同时监控多个 IMAP 邮箱（Gmail、QQ 邮箱、163 邮箱、Outlook、校园邮箱等）
- 自动推送 — 后台定时轮询（默认 5 分钟），收到新邮件时自动通过 QQ 私聊推送通知
- 邮件摘要 — 通知包含发件人、主题、时间和正文预览
- AI 摘要（可选）— 调用 LLM 对邮件内容生成简洁中文摘要
- 手动查询 — 可按日期范围查询指定邮箱的历史邮件
- 手动回复 — 在聊天里通过指令手动发送邮件回复（基于 SMTP）
- WebUI 配置 — 在 AstrBot 管理面板中可视化配置，无需修改代码
- 智能过滤 — 只通知插件启用后收到的新邮件，不会推送历史旧邮件
- 零额外依赖 — 使用 Python 标准库
imaplib、smtplib和email，无需安装第三方包
在 AstrBot WebUI → 插件管理 → 📬 邮件通知 → 配置中，点击「邮箱账户列表」添加邮箱：
| 字段 | 说明 | 示例 |
|---|---|---|
| 账户备注名 | 自定义名称，方便识别 | qq邮箱 |
| IMAP 服务器地址 | 邮箱的 IMAP 服务器 | imap.qq.com |
| IMAP 端口 | SSL 通常为 993 | 993 |
| 邮箱地址 | 你的邮箱地址 | 123456@qq.com |
| 密码/应用专用密码 | 见下方各邮箱获取方式 | xxxxxxxxxxxxxxxx |
| SMTP 服务器地址 | 邮箱的 SMTP 服务器 | smtp.qq.com |
| SMTP 端口 | SSL 常用 465，STARTTLS 常用 587 | 465 |
| SMTP 使用 SSL 连接 | 推荐开启 | true |
| SMTP 密码/应用专用密码 | 留空则复用上方密码字段 | xxxxxxxxxxxxxxxx |
| 间隔时间 | 轮询间隔(分钟) | 60 |
| 管理员UID列表 | 只有列表里的用户可以使用插件命令 | QQ号/微信号 |
| 通知目标会话ID | 建议通过/mail_bind自动绑定，也可以手动填写 | test:GroupMessage:qq群号 |
| 启用AI摘要 | 推荐开启 | true |
| 使用 SSL 连接 | 推荐开启 | true |
| 启用黑白名单过滤 | 自行启动 | true |
| 发件人规则 | 可填写完整邮箱、域名后缀或关键词 | qq.com |
| 主题规则 | 可填写关键字 | 广告 |
| 正文规则 | 可填写关键字 | 广告 |
可添加多个邮箱账户，每个账户独立监控。
在 QQ 私聊中给机器人发送：
/mail_bind
机器人会回复"✅ 已绑定"，之后新邮件通知就会发到这个私聊。
/mail_check
手动触发一次检查，确认邮箱连接正常。之后插件会自动后台轮询。
| 指令 | 说明 | 示例 |
|---|---|---|
/mail_bind |
绑定当前会话为邮件通知推送目标 | /mail_bind |
/mail_check |
立即手动检查所有邮箱的新邮件 | /mail_check |
/mail_status |
查看所有邮箱的连接状态和最近检查时间 | /mail_status |
/mail_query |
查询指定邮箱自某日期以来的邮件（最多 20 条） | /mail_query qq邮箱 2026-03-01 |
/mail_reply |
使用指定账户手动发送邮件回复（管理员） | /mail_reply qq邮箱 test@example.com 回复主题|你好，已收到你的邮件。 |
/mail_query <账户备注名> <起始日期>
<账户备注名>：你在配置中填写的名称，如qq邮箱、谷歌邮箱<起始日期>：格式为YYYY-MM-DD，如2026-03-01
示例：
/mail_query qq邮箱 2026-03-01
会返回该邮箱自 2026 年 3 月 1 日以来的邮件列表。
/mail_reply <账户备注名> <收件人邮箱> <主题>|<正文>
<账户备注名>：你在配置中填写的名称，如qq邮箱、谷歌邮箱<收件人邮箱>：目标收件人邮箱地址<主题>|<正文>：使用|分隔主题和正文，正文支持空格（|必须是英文半角竖线）
示例：
/mail_reply qq邮箱 test@example.com 回复主题|你好，已收到你的邮件。
Important
/mail_reply 需要先配置对应邮箱的 SMTP 信息，且默认仅管理员可用。
Important
大多数邮箱不允许直接使用登录密码连接 IMAP，需要使用「应用专用密码」或「授权码」。
Gmail 必须使用应用专用密码，普通登录密码无法连接 IMAP。
- 前往 Google 账户安全设置
- 确保已开启两步验证（2-Step Verification）
- 如未开启：安全性 → 两步验证 → 添加手机号 → 完成验证
- 开启两步验证后，前往 应用专用密码页面
- 输入应用名称（如
AstrBot）→ 点击「创建」 - 复制生成的 16 位密码（如
abcd efgh ijkl mnop） - 将此密码填入插件配置的密码字段（空格可去可不去）
Tip
应用专用密码只显示一次，关掉页面后无法再查看。如果忘了，删除后重新生成一个即可。
Warning
在国内直连 imap.gmail.com 可能超时（被 GFW 屏蔽），需要代理或使用国内邮箱。
QQ 邮箱必须使用授权码，不能使用 QQ 密码。（只能在网页端操作）
- 登录 QQ 邮箱网页版
- 进入 设置 → 账号
- 找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服务」
- 若没开启，点击 管理服务 开启 IMAP/SMTP 服务
- 点击 生成授权码
- 按提示用手机发送短信验证
- 验证成功后会显示一个 16 位授权码
- 将此授权码填入插件配置的密码字段
163 邮箱必须使用授权码。
- 登录 163 邮箱网页版
- 进入 设置 → POP3/SMTP/IMAP
- 开启 IMAP/SMTP 服务
- 按提示设置授权码（需要手机验证）
- 将授权码填入插件配置的密码字段
- 登录 数字杭电，从此进入邮箱
- 进入邮箱后点击 设置
- 点击 账号与安全
- 点击 客户端设置，点击 进入设置
- 打开 客户端授权密码，点击 生成客户端授权密码
Outlook 可以直接使用账户登录密码。
- IMAP 服务器：
outlook.office365.com - 端口：
993 - 密码：直接使用 Microsoft 账户密码
Tip
如果账户开启了两步验证，也需要生成应用密码：Microsoft 应用密码
各学校邮箱配置不同，一般步骤：
- 登录学校邮箱网页版
- 在设置中确认是否开启了 IMAP 服务（部分学校默认关闭）
- 查找 IMAP 服务器地址（通常为
imap.xxx.edu.cn） - 密码通常使用邮箱登录密码
常见校园邮箱配置示例：
| 学校 | IMAP 服务器 | 端口 |
|---|---|---|
| 杭电 | imap.hdu.edu.cn |
993 |
| 浙大 | imap.zju.edu.cn |
993 |
Note
如果连接失败，请联系学校信息中心确认是否开放了 IMAP 服务。
由于 GFW 屏蔽，国内服务器直连 imap.gmail.com 会超时。以下是两种解决方案：
如果你的服务器上已经有代理客户端（如 Clash、v2rayA 等），开启 TUN 模式 或 系统全局代理 即可让 Python 的 IMAP 连接走代理。
[!WARNING] 普通 HTTP/SOCKS5 代理对
imaplib无效（它直接建立 TCP socket），必须使用 TUN 模式接管系统全部流量。
不需要代理，将 Gmail 收到的邮件自动转发到 QQ 邮箱，然后只监控 QQ 邮箱即可。
设置步骤：
- 在电脑上打开 Gmail 网页版
- 点击右上角 ⚙️ → 查看所有设置
- 进入 「转发和 POP/IMAP」 标签页
- 点击 「添加转发地址」，输入你的 QQ 邮箱地址
- 前往 QQ 邮箱收取确认邮件，点击确认链接或输入确认码
- 回到 Gmail 设置页面，选择 「将收到的邮件转发到 xxx@qq.com」
- 点击页面底部的**「保存更改」**
[!CAUTION] 第 7 步「保存更改」很容易遗漏！不点保存则转发规则不会生效。
设置完成后，所有发到 Gmail 的邮件都会自动转发到 QQ 邮箱，插件只需监控 QQ 邮箱即可收到通知。
在 WebUI 插件配置中还可以调整：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 检查间隔（分钟） | 5 | 后台轮询间隔，建议不低于 2 分钟 |
| 启用 AI 摘要 | 关闭 | 开启后使用 LLM 对邮件生成中文摘要 |
| 邮件正文最大截取长度 | 500 | 预览或 AI 摘要输入的正文字符数上限 |
| 通知显示时区 | Asia/Shanghai |
前端下拉可直接选择常见时区；若选择“自定义时区”，再填写 IANA 时区名称，例如 Asia/Singapore、Australia/Sydney |
📬 新邮件通知 [qq邮箱]
━━━━━━━━━━━━━━━━
📤 发件人: 张三 <zhangsan@example.com>
📋 主题: 关于项目进度汇报
🕐 时间: 2026-03-07 14:30（北京时间）
📝 预览: 你好，本周项目已完成模块A的开发...
开启 AI 摘要后：
📬 新邮件通知 [qq邮箱]
━━━━━━━━━━━━━━━━
📤 发件人: 张三 <zhangsan@example.com>
📋 主题: 关于项目进度汇报
🕐 时间: 2026-03-07 14:30（北京时间）
📝 AI摘要: 通知项目进度：模块A已完成开发，下周将进入测试阶段。
Q: 连接超时 (timed out)？
- Gmail: 在国内被墙，需要代理或改用国内邮箱
- 其他邮箱: 检查 IMAP 服务器地址和端口是否正确，确认邮箱已开启 IMAP 服务
Q: 认证失败 (LOGIN failed)？
- 检查密码是否正确，Gmail 和 QQ 邮箱不能使用登录密码，必须使用应用专用密码/授权码
- QQ 邮箱确认已开启 IMAP 服务
Q: 收到了很多旧邮件通知？
- 插件已加入日期过滤机制，只通知启用后收到的新邮件。如仍有问题，在 WebUI 中重载插件即可
Q: 后台不自动检查？
- 确认已通过
/mail_bind绑定通知目标 - 通过
/mail_status查看状态
Q: /mail_reply 发送失败？
- 检查 SMTP 服务器、端口、SSL 配置是否正确
- 检查 SMTP 密码/授权码是否可用（部分邮箱和 IMAP 不是同一凭据）
- 确认收件人邮箱格式正确，主题与正文不为空
- 添加黑白名单规则
- 时区时间转化
- 兼容网易邮箱
- 添加管理员列表，唯管理员有权限使用指令
- 增加发邮件功能
- 支持多邮箱 IMAP 新邮件监控与自动通知
- 支持 AI 摘要、手动检查、状态查看与历史查询
- 请先在web界面中配置“admin_uid”.
- 唯有管理员有权使用指令.
QQ: 964389211
如果本插件有bug或有建议，欢迎提出Issues和PRs，也可以直接联系作者qq。
AGPL-3.0