QQ Email Skill for Openclaw

A comprehensive integration for sending and receiving emails through QQ Mail using SMTP and IMAP protocols.

chao-nj-cn
v1.0.0
Mar 2, 2026
1
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install qq-email

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install qq-email using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is QQ Email Skill?

The QQ Email Skill is a specialized tool designed for Openclaw Skills that empowers AI agents to manage email communications directly through a QQ Mail account. It bridges the gap between your automated workflows and your inbox, allowing for seamless sending and receiving of messages using secure SMTP and IMAP protocols. This skill is ideal for developers and power users who need to automate notifications, share documents, or monitor incoming mail within their AI-driven environment.

QQ Email Skill Use Cases

  • Automating the delivery of reports or project updates to stakeholders via email.
  • Monitoring a QQ Mail inbox for specific unread messages or urgent notifications.
  • Sharing local workspace documents and files as email attachments.
  • Programmatically marking emails as read or downloading attachments for further processing.
  • Sending formatted HTML emails for professional communication needs.

How QQ Email Skill Works

  1. The user initiates a request such as sending a file or checking recent emails.
  2. The Openclaw Skills agent identifies the required parameters like recipient, subject, or message UID.
  3. The skill executes the underlying Python script using the configured SMTP (for sending) or IMAP (for receiving) credentials.
  4. Secure communication is established with smtp.qq.com or the corresponding IMAP server using an authorization code.
  5. The action is completed, and the agent provides a confirmation or displays the retrieved email data to the user.

QQ Email Skill Setup

To get started, you must generate a 16-character authorization code from the QQ Mail web interface (Settings -> Account -> Enable POP3/SMTP). Once obtained, configure your credentials in the TOOLS.md file:

### QQ Email

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

Ensure Python 3 is installed, as the skill relies on a local script located at ~/.openclaw/workspace/skills/qq-email/qq_email.py.

QQ Email Skill Data Schema & Taxonomy

The skill interacts with email data using the following schema for its CLI-based operations:

Attribute Description Required
--to Destination email address Yes (Send)
--subject The subject line of the email Yes (Send)
--content The body text or HTML content Yes (Send)
--uid Unique identifier for specific emails Yes (Read/Mark)
--attachment Path to a local file (max 50MB) Optional
--unread Filter to only show unread messages Optional

QQ Email Skill Advanced Features

  • Support for HTML-formatted content to send rich-text emails.
  • Attachment handling for both sending files and saving incoming attachments to the local workspace.
  • Granular inbox management including fetching specific counts of recent emails and marking messages as read.
  • Automatic synchronization with the QQ Mail 'Sent' folder for all outgoing messages.
  • Secure SSL connectivity via port 465 to ensure data privacy during transmission.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*