qq-email-operator

用途

QQ 邮箱操作技能用于通过 IMAP/SMTP 协议对 QQ 邮箱进行邮件管理，适合需要以命令行方式读取、搜索、回复和发送 QQ 邮件的场景。

主要能力

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

前置条件

QQ 邮箱已开启 IMAP/SMTP 服务
授权码已存入 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

使用方式

读取最近邮件：

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

搜索特定邮件：

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

读取邮件正文：

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

回复邮件：

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

发送新邮件：

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py send \
  --account REDACTED_EMAIL \
  --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 路径	状态
REDACTED_EMAIL	email/qq/2067089451	✅ 已验证

注意事项

授权码 ≠ QQ密码，需在 QQ 邮箱设置中单独生成
海外服务器连接 QQ 邮箱可能需要代理
SMTP 发送建议用 465 端口（SSL）
回复邮件自动设置 In-Reply-To 和 References 头以保持邮件线程

限制

删除邮件被禁止
回复和发送邮件需要确认
需预先配置 QQ 邮箱 IMAP/SMTP 服务及 pass 授权码
海外服务器连接可能需要代理

技能介绍

用途

主要能力

前置条件

服务器配置

使用方式

触发词

安全策略

已配置账号

注意事项

限制