QQ Email Skill
Send and receive emails via QQ Mail SMTP/IMAP server.
When to Use
✅ USE this skill when:
- - "Send an email to..."
- "Check my emails"
- "Read my unread emails"
- "Email this to [someone]"
- "Notify [person] via email"
- "Share this document via email"
- "What's in my inbox?"
When NOT to Use
❌ DON'T use this skill when:
- - Sending SMS/WhatsApp → use messaging tools
- Internal notes → use memory files
- Public posts → use social media tools
Configuration Required
Before using, configure in TOOLS.md:
CODEBLOCK0
Get QQ Auth Code:
- 1. Login to mail.qq.com
- Settings → Account
- Enable POP3/SMTP service
- Generate authorization code (16 characters)
Commands
Send Email
CODEBLOCK1
Receive/List Emails
CODEBLOCK2
Read Specific Email
CODEBLOCK3
Mark Email as Read
CODEBLOCK4
Send HTML Email
CODEBLOCK5
Send with Attachment
CODEBLOCK6
Quick Responses
"Send an email to test@example.com"
→ Ask for subject and content, then:
CODEBLOCK7
"Email this file to someone"
→ Ask for recipient and add attachment:
CODEBLOCK8
Notes
- - Auth code ≠ QQ password (get from mail.qq.com settings)
- SMTP server: smtp.qq.com:465 (SSL)
- Rate limited: ~50 emails/hour for free accounts
- Attachments ≤ 50MB per email
- All sent emails saved in QQ Mail "Sent" folder
QQ 邮件技能
通过 QQ 邮箱 SMTP/IMAP 服务器发送和接收邮件。
使用时机
✅ 使用此技能的场景:
- - 发送邮件给...
- 查看我的邮件
- 阅读未读邮件
- 将邮件发送给[某人]
- 通过邮件通知[某人]
- 通过邮件分享此文档
- 我的收件箱里有什么?
不使用时机
❌ 不要使用此技能的场景:
- - 发送短信/WhatsApp → 使用消息工具
- 内部笔记 → 使用记忆文件
- 公开发帖 → 使用社交媒体工具
所需配置
使用前,在 TOOLS.md 中配置:
markdown
QQ 邮箱
- - 邮箱:yourqqnumber@qq.com
- 授权码:your16charauthcode
- 发件人名称:Your Name
获取 QQ 授权码:
- 1. 登录 mail.qq.com
- 设置 → 账户
- 开启 POP3/SMTP 服务
- 生成授权码(16位字符)
命令
发送邮件
bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
--to recipient@example.com \
--subject 邮件主题 \
--content 邮件内容
接收/列出邮件
bash
列出最近10封邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive
列出20封邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --count 20
仅未读邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --unread
阅读指定邮件
bash
按UID阅读邮件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123
阅读并保存附件
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123 --save
标记邮件为已读
bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py mark-read --uid 123
发送HTML邮件
bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
--to recipient@example.com \
--subject HTML邮件 \
--content
你好
HTML内容
\
--html
发送带附件的邮件
bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send \
--to recipient@example.com \
--subject 附件文档 \
--content 请查收附件。 \
--attachment /path/to/file.pdf
快速响应
发送邮件给 test@example.com
→ 询问主题和内容,然后:
bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py --to test@example.com --subject [主题] --content [内容]
将此文件通过邮件发送给某人
→ 询问收件人并添加附件:
bash
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py --to [邮箱] --subject [主题] --content [内容] --attachment [文件]
注意事项
- - 授权码 ≠ QQ密码(从 mail.qq.com 设置中获取)
- SMTP服务器:smtp.qq.com:465(SSL)
- 频率限制:免费账户约50封/小时
- 附件限制:每封邮件不超过50MB
- 所有已发送邮件保存在QQ邮箱的已发送文件夹中