← Back to Skills Marketplace
355
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install qq-mail-reader
Description
读取QQ邮箱邮件。使用IMAP协议连接QQ邮箱，支持多种编码解析。触发场景：用户要求查看邮箱、读取邮件、查看最近邮件、筛选特定邮件等。
Usage Guidance
This skill legitimately needs an email address and an IMAP authorization code to read your QQ mailbox. Before installing: (1) only provide an app-specific QQ IMAP authorization code (not your account password); (2) store the code in the indicated secrets file with strict permissions (chmod 600) and avoid committing it to source control; (3) be aware the skill will read email contents — only install if you trust the skill and the agent runtime; (4) prefer short-lived/rotated credentials when possible and monitor account activity; (5) if you need stronger isolation, consider running mailbox access in a separate environment or using a dedicated read-only mailbox.
Capability Analysis
Type: OpenClaw Skill
Name: qq-mail-reader
Version: 1.0.5
The skill provides standard Python implementation for reading QQ Mail via the IMAP protocol. It includes legitimate code for connecting to imap.qq.com, decoding email headers, and parsing message bodies. The documentation correctly emphasizes security best practices, such as using app-specific authorization codes and setting restrictive file permissions (600) on credential files.
Capability Assessment
Purpose & Capability
The skill is described as an IMAP-based QQ mailbox reader and requires MAIL_USER and MAIL_PASS plus a secrets file in ~/.openclaw/secrets/mail_qq.env. These requirements align with needing an email address and an IMAP authorization code to log in to imap.qq.com.
Instruction Scope
SKILL.md contains concrete Python IMAP usage and parsing/decoding routines that stay within the stated scope (connect, search, decode, extract body, filter). It does not instruct reading unrelated system files or contacting external endpoints beyond the IMAP server. It does instruct storing credentials in a local secrets file (expected for this use).
Install Mechanism
This is an instruction-only skill with no install spec and no code files. No packages or remote downloads are requested, so there is minimal install risk.
Credentials
Requesting MAIL_USER and MAIL_PASS (QQ IMAP authorization code) is proportionate to reading email, but these are highly sensitive credentials. The metadata also points to a specific local secrets file path. This is expected for an email reader, but users should treat the auth code as sensitive, store it with correct permissions (as the doc suggests), and only provide it to trusted agents.
Persistence & Privilege
always is false and the skill does not request persistent elevated privileges or modify other skills or system-wide agent settings. It only references its own secrets file and runtime env.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qq-mail-reader - After installation, invoke the skill by name or use
/qq-mail-reader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Updated metadata format for required environment variables and config file references.
- Changed "env-vars" to "env" and "credential-file" to "config" under metadata.openclaw.
- No functional or code changes; documentation/metadata update only.
v1.0.4
- Added a homepage link for QQ邮箱官方帮助文档
- Introduced metadata section with Openclaw integration (emoji, environment variables, credential file, install steps)
- No changes to code or core functionality
v1.0.3
- Updated skill metadata formatting in SKILL.md: moved fields like required-env-vars, primary-credential, and credential-location outside the metadata block.
- No functional or code changes; documentation and configuration remain the same.
v1.0.2
No user-facing or internal changes in this version.
- No file changes detected; skill functionality and instructions remain the same.
v1.0.1
- 增加了 metadata 字段，明确要求 MAIL_USER 和 MAIL_PASS 环境变量，并说明凭据存储位置和主要认证方式
- 新增安全说明，提醒凭据文件权限设置、目录以及授权码泄露风险
- 其余功能和使用方法保持不变
v1.0.0
Initial release of QQ邮箱邮件读取技能。
- 支持使用 IMAP 协议连接 QQ 邮箱，读取收件箱邮件内容
- 兼容多种邮件编码（如 GBK/GB2312/UTF-8）
- 自动解析邮件标题和正文，提取纯文本内容
- 支持按日期（如最近、当天）和关键词（如通知、订单）检索邮件
- 提示 IMAP/授权码配置方法，便于快速使用
Metadata
Frequently Asked Questions
What is qq-mail-reader?
读取QQ邮箱邮件。使用IMAP协议连接QQ邮箱，支持多种编码解析。触发场景：用户要求查看邮箱、读取邮件、查看最近邮件、筛选特定邮件等。 It is an AI Agent Skill for Claude Code / OpenClaw, with 355 downloads so far.
How do I install qq-mail-reader?
Run "/install qq-mail-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is qq-mail-reader free?
Yes, qq-mail-reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does qq-mail-reader support?
qq-mail-reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created qq-mail-reader?
It is built and maintained by ZaviWayne (@zaviwayne); the current version is v1.0.5.
More Skills