qq-email-operator

Installation
SKILL.md

QQ 邮箱操作技能

当使用此技能

  • 读取 QQ 邮箱收件箱
  • 搜索特定发件人/主题的邮件
  • 回复邮件(英文/中文)
  • 发送新邮件
  • 查看邮件详情(正文、附件信息)

前置条件

  1. QQ 邮箱已开启 IMAP/SMTP 服务
  2. 授权码已存入 pass
    • pass show email/qq/<邮箱地址>
    • pass show email/qq/<QQ号>

服务器配置

协议 服务器 端口 SSL
IMAP imap.qq.com 993
SMTP smtp.qq.com 465 ✅ SSL
SMTP smtp.qq.com 587 ✅ STARTTLS

使用方法

1. 读取最近邮件

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py list --account 2067089451@qq.com --limit 10

2. 搜索特定邮件

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py search --account 2067089451@qq.com --from "vince@example.com"
python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py search --account 2067089451@qq.com --subject "keyword"

3. 读取邮件正文

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py read --account 2067089451@qq.com --id 948

4. 回复邮件

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py reply \
  --account 2067089451@qq.com \
  --id 948 \
  --body "Your reply text here" \
  --sender-name "Daniel Li"

5. 发送新邮件

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py send \
  --account 2067089451@qq.com \
  --to "recipient@example.com" \
  --subject "Subject" \
  --body "Email body" \
  --sender-name "Daniel Li"

触发词

  • "查看QQ邮箱"
  • "读取QQ邮件"
  • "回复QQ邮件"
  • "发送QQ邮件"
  • "搜索QQ邮件"
  • "QQ邮箱操作"
  • "reply to email"
  • "send email via QQ"

安全策略

操作 权限
读取邮件列表 🟢 自动
读取邮件正文 🟢 自动
搜索邮件 🟢 自动
回复邮件 🟡 需确认
发送新邮件 🟡 需确认
删除邮件 🔴 禁止

已配置账号

邮箱 pass 路径 状态
2067089451@qq.com email/qq/2067089451 ✅ 已验证

注意事项

  • 授权码 ≠ QQ密码,需在 QQ 邮箱设置中单独生成
  • 海外服务器连接 QQ 邮箱可能需要代理
  • SMTP 发送建议用 465 端口(SSL)
  • 回复邮件自动设置 In-Reply-To 和 References 头以保持邮件线程
Weekly Installs
1
GitHub Stars
52
First Seen
Mar 17, 2026