SkillHub

qq-email

v1.0.0

Send and receive emails via QQ Mail SMTP/IMAP. Use when: user wants to send/receive emails, check inbox, read messages, or share documents via email. Requires QQ email authorization code configured in TOOLS.md.

Sourced from ClawHub, Authored by Chao-NJ-CN

Installation

Please help me install the skill `qq-email` from SkillHub official store. npx skills add Chao-NJ-CN/qq-email

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:

### QQ Email

- Email: [email protected]
- Auth Code: your_16_char_auth_code
- Sender Name: Your Name

Get QQ Auth Code: 1. Login to mail.qq.com 2. Settings → Account 3. Enable POP3/SMTP service 4. Generate authorization code (16 characters)

Commands

Send Email

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send 
  --to "[email protected]" 
  --subject "Email Subject" 
  --content "Email content here"

Receive/List Emails

# List 10 recent emails
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive

# List 20 emails
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --count 20

# Unread emails only
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py receive --unread

Read Specific Email

# Read email by UID
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123

# Read and save attachments
python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py read --uid 123 --save

Mark Email as Read

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py mark-read --uid 123

Send HTML Email

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send 
  --to "[email protected]" 
  --subject "HTML Email" 
  --content "<h1>Hello</h1><p>HTML content</p>" 
  --html

Send with Attachment

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py send 
  --to "[email protected]" 
  --subject "Document Attached" 
  --content "Please find attached." 
  --attachment "/path/to/file.pdf"

Quick Responses

"Send an email to [email protected]"

→ Ask for subject and content, then:

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py --to "[email protected]" --subject "[subject]" --content "[content]"

"Email this file to someone"

→ Ask for recipient and add attachment:

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py --to "[email]" --subject "[subject]" --content "[content]" --attachment "[file]"

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