QQ Email Skill

---

name: qq-email

description: "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."

homepage: https://mail.qq.com

metadata: { "openclaw": { "emoji": "📧", "requires": { "bins": ["python3"], "files": ["~/.openclaw/workspace/skills/qq-email/qq_email.py", "~/.openclaw/workspace/TOOLS.md"] } } }

---

# QQ Email Skill

Send and receive emails via QQ Mail SMTP/IMAP server.

When to Use

✅ **USE this skill when:**

When NOT to Use

❌ **DON'T use this skill when:**

Configuration Required

Before using, configure in `TOOLS.md`:

### QQ Email

- Email: your_qq_number@qq.com
- 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 "recipient@example.com" \
  --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 "recipient@example.com" \
  --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 "recipient@example.com" \
  --subject "Document Attached" \
  --content "Please find attached." \
  --attachment "/path/to/file.pdf"

Quick Responses

**"Send an email to test@example.com"**

→ Ask for subject and content, then:

python3 ~/.openclaw/workspace/skills/qq-email/qq_email.py --to "test@example.com" --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