A Python-based skill for managing QQ Mail accounts via secure IMAP and SMTP protocols for automated email handling.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install qqmail
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install qqmail 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 Mail Manager?
The QQ Mail Manager is a robust technical skill designed to bridge AI agents with the QQ Mail ecosystem. By utilizing standard IMAP and SMTP protocols, this skill empowers developers to programmatically interact with their mailbox, enabling features like inbox monitoring, automated message delivery, and complex search queries. As a key component of the Openclaw Skills ecosystem, it ensures that Chinese charset detection and secure authentication are handled natively.
This tool is particularly valuable for developers who need to integrate email-based triggers or notifications into their automated workflows. By using a specialized authorization code instead of a primary password, it maintains a high security standard while providing full access to mailbox folders, attachments, and historical data retrieval.
QQ Mail Manager Use Cases
- Automating the delivery of scheduled reports with PDF or document attachments.
- Building an AI-driven notification system that monitors the inbox for specific keywords.
- Retrieving historical project details or communication threads using date-based search filters.
- Managing and organizing diverse mailbox folders to streamline communication workflows using Openclaw Skills.
- Integrating email reading capabilities into data pipelines for sentiment analysis or task extraction.
How QQ Mail Manager Works
- The skill establishes a secure SSL connection to the QQ Mail IMAP server (imap.qq.com:993) for retrieval or the SMTP server (smtp.qq.com:465) for transmission.
- It authenticates the session using the QQMAIL_USER email address and the mandatory QQMAIL_AUTH_CODE generated from the user's account settings.
- Upon command execution, the script interacts with the mail server to list folders, fetch email headers, or search for specific UID ranges.
- For reading operations, the skill automatically detects the character encoding to ensure Chinese text is rendered correctly within the environment.
- For sending operations, it constructs a MIME message structure, handles optional file attachments, and transmits the data via SMTP.
QQ Mail Manager Setup
To get started with this skill in the Openclaw Skills library, follow these steps:
- Enable IMAP/SMTP: Log in to mail.qq.com, go to Settings -> Account, and enable the IMAP/SMTP service.
- Generate Authorization Code: Click the button to generate a 16-character authorization code. Save this; it is not your regular password.
- Configure Environment: Set the following environment variables in your system or agent configuration:
export QQMAIL_USER="[email protected]"
export QQMAIL_AUTH_CODE="your_16_char_code"
- Verify Python 3: Ensure your environment has Python 3 installed as it uses the standard library for all operations.
QQ Mail Manager Data Schema & Taxonomy
The skill processes and returns email data in a structured format suitable for AI agents. Below is the metadata taxonomy for email objects:
| Attribute | Description | Data Type |
|---|---|---|
| index | The numerical ID of the email in the current view | Integer |
| from | The sender's email address and display name | String |
| subject | The title of the email message | String |
| date | The timestamp when the email was received | String |
| body | The full text content of the email | String |
| folders | A list of available mailbox directories | Array of Strings |
| attachment | Path to local files for outgoing mail | String |
QQ Mail Manager Advanced Features
- Support for multipart MIME messages to handle diverse attachment types programmatically.
- Multi-parameter search capability combining subject keywords, sender addresses, and date ranges (since).
- Zero-dependency architecture ensuring compatibility across Windows, Linux, and macOS without additional pip packages.
- Advanced folder management allowing agents to switch contexts between Inbox, Sent Messages, and custom labels.
- Specialized charset detection for high-fidelity rendering of Chinese characters within Openclaw Skills pipelines.
SKILL.md
Loading
Related Openclaw Skills
Microsoft Docs
An official gateway to search and retrieve live technical documentation from the Microsoft Learn platform.
CCXT Cryptocurrency Exchange Trading
A comprehensive CLI integration for interacting with over 100 cryptocurrency exchanges to fetch market data and execute trades.
Feishu Mention Bot
A specialized tool for programmatically @mentioning robots within Feishu group chats to trigger automated workflows and inter-agent communication.
Bilibili Analytics
A professional data extraction and analysis tool for Bilibili search results, generating structured reports on trends and engagement.
YouTube Publisher
A professional-grade automation tool for uploading videos, managing metadata, and organizing playlists via the YouTube Data API v3.
Follow-Up Sequence Writer
An automated sequence generator for creating professional, multi-touch email and SMS follow-up campaigns tailored to specific business industries and tones.
METADATA
Featured*
