qq-email-operator

v2026.09.24

QQ邮箱操作技能。支持通过 IMAP/SMTP 读取邮件、搜索邮件、回复邮件、发送邮件。凭据通过 pass 安全存储。

GitHub
Install command
npx skhub add aaaaqwq/qq-email-operator
Markdown
SKILL.md

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
IMAPimap.qq.com993✅
SMTPsmtp.qq.com465✅ SSL
SMTPsmtp.qq.com587✅ STARTTLS

使用方法

1. 读取最近邮件

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

2. 搜索特定邮件

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"

3. 读取邮件正文

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

4. 回复邮件

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"

5. 发送新邮件

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_EMAILemail/qq/2067089451✅ 已验证

注意事项

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

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/qq-email-operator

Default branch

main

Latest commit

b996aac

Tree SHA

07e787b