A specialized skill for AI agents to securely connect to QQ Mail via IMAP for automated email retrieval and parsing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install qq-mail-reader
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 qq-mail-reader 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 Reader?
The QQ Mail Reader is a robust integration designed for Openclaw Skills that allows AI coding agents to interact directly with QQ Mail inboxes. By utilizing the IMAP protocol, this skill provides a bridge for agents to fetch recent messages, search for specific communications, and handle complex email formats.
This skill is particularly valuable for developers who need their AI agents to monitor notifications, extract data from business emails, or manage communications without leaving their development environment. It ensures high compatibility by supporting various character encodings commonly found in Chinese email systems, such as GBK and GB2312.
QQ Mail Reader Use Cases
- Automatically check for new emails or specific system notifications.
- Search and retrieve messages received within a specific date range.
- Parse and summarize long email threads or business reports.
- Extract clean text from HTML-formatted orders, shipping updates, or interview invitations.
How QQ Mail Reader Works
- The agent establishes a secure SSL connection to the QQ IMAP server on port 993.
- Authentication is performed using a specialized authorization code rather than a standard login password for enhanced security.
- The skill selects the appropriate mailbox folder and performs a search using date-based criteria.
- Headers and bodies are processed through a decoding pipeline that handles multiple character sets to prevent text corruption.
- HTML content is stripped and sanitized into plain text, making it digestible for the AI agent within the Openclaw Skills ecosystem.
QQ Mail Reader Setup
To use this skill, first enable the IMAP service in your QQ Mail settings and generate an authorization code. Then, configure your environment:
mkdir -p ~/.openclaw/secrets
touch ~/.openclaw/secrets/mail_qq.env
chmod 600 ~/.openclaw/secrets/mail_qq.env
Add your credentials to the file:
[email protected]
MAIL_PASS=your_authorization_code
QQ Mail Reader Data Schema & Taxonomy
The skill organizes email data using the following structure for consistent processing:
| Attribute | Description | Data Type |
|---|---|---|
| MAIL_USER | Your registered QQ email address | String |
| MAIL_PASS | The IMAP authorization code (secret) | String |
| Encoding | Fallback logic for UTF-8, GBK, and BIG5 | List |
| Clean Text | Sanitized message body free of HTML tags | String |
QQ Mail Reader Advanced Features
- Multi-encoding fallback mechanism to ensure readability across different email clients.
- Localized filtering logic that compensates for IMAP's native search limitations regarding non-ASCII characters.
- Automated HTML-to-text conversion to optimize token usage for AI models.
- Secure credential management integrated with Openclaw Skills file permission standards.
SKILL.md
Loading
Related Openclaw Skills
Obsidian
Automate your Obsidian Markdown vaults and streamline personal knowledge management using Openclaw Skills.
Inception Token Optimizer
A high-efficiency toolkit designed to minimize token consumption and manage API costs for Inception Labs models.
PPT Agent
An AI-powered presentation agent that transforms user themes into editable, professional-grade SVG slides using a structured Bento Grid layout.
HPC OpenFOAM
A specialized AI agent skill designed to automate the generation, validation, and error recovery of OpenFOAM CFD simulation cases.
Configure Telerik NuGet
A specialized automation skill for securely setting up and managing Telerik NuGet feeds using environment variable expansion.
Cron Skill
A local-first recurring schedule engine that converts natural language timing into structured execution plans for reminders and repeated tasks.
Featured*
