qq-email-operator

name	qq-email-operator
description	QQ邮箱操作技能。支持通过 IMAP/SMTP 读取邮件、搜索邮件、回复邮件、发送邮件。凭据通过 pass 安全存储。
license	MIT
metadata	{"version":"1.0.0","domains":["email","automation","communication"],"type":"automation"}
author	Daniel Li

QQ 邮箱操作技能

• Author: Daniel Li
• Copyright © Daniel Li. All rights reserved.

当使用此技能

• 读取 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 [e-mail] --limit 10

2. 搜索特定邮件

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py search --account [e-mail] --from "[e-mail]"
python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py search --account [e-mail] --subject "keyword"

3. 读取邮件正文

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py read --account [e-mail] --id 948

4. 回复邮件

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

5. 发送新邮件

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py send \
  --account [e-mail] \
  --to "[e-mail]" \
  --subject "Subject" \
  --body "Email body" \
  --sender-name "Daniel Li"

触发词

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

安全策略

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

已配置账号

邮箱	pass 路径	状态
[e-mail]	email/qq/2067089451	✅ 已验证

注意事项

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