邮件管理

SkillCommunication

Send and receive email via QQ or 163 mailboxes. Supports sending plain emails, emails with attachments, receiving emails, and checking for new mail. Use when the user asks to send, view, or check emails.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the 邮件管理 skill

What this skill tells your AI

The instructions your AI receives, as published by countbot-ai/countbot in workspace/skills/email/SKILL.md and read by ahel’s review.

通过 QQ 或 163 邮箱发送和接收邮件。

配置

编辑 skills/email/scripts/config.json,填写邮箱地址和授权码(非登录密码)。

授权码获取:

  • QQ 邮箱:设置 > 账户 > 开启 IMAP/SMTP > 生成授权码
  • 163 邮箱:设置 > POP3/SMTP/IMAP > 开启服务 > 设置授权密码

可通过 default_mailbox 字段设置默认邮箱("qq""163")。

命令行调用

# 发送邮件
python3 skills/email/scripts/mail.py send --to user@example.com --subject "主题" --content "内容"

# 发送带附件
python3 skills/email/scripts/mail.py send --to user@example.com --subject "报告" --content "请查收" --attach report.pdf

# 接收最新邮件
python3 skills/email/scripts/mail.py receive --limit 5

# 接收邮件(JSON 输出,推荐 AI 使用)
python3 skills/email/scripts/mail.py receive --limit 5 --json

# 检查新邮件(最近 N 天)
python3 skills/email/scripts/mail.py check-new --since 1

# 检查新邮件(JSON 输出)
python3 skills/email/scripts/mail.py check-new --since 1 --json

# 删除邮件(移到已删除文件夹,QQ邮箱可恢复)
python3 skills/email/scripts/mail.py delete --ids 123

# 批量删除
python3 skills/email/scripts/mail.py delete --ids 123 124 125

# 彻底删除(不可恢复)
python3 skills/email/scripts/mail.py delete --ids 123 --permanent

# 指定邮箱类型
python3 skills/email/scripts/mail.py --mailbox 163 send --to user@example.com --subject "测试"

删除邮件说明

  • QQ 邮箱(IMAP):默认移到「已删除」文件夹,可以从已删除中恢复。加 --permanent 彻底删除。
  • 163 邮箱(POP3):POP3 协议不支持文件夹操作,删除始终是永久的,不可恢复。

Signals

GitHub stars
777
Forks
101
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
email
Source
github.com/countbot-ai/countbot