Agent Skills › virgo777/buddyme › qqmail

qqmail

GitHub

通过IMAP/SMTP协议管理QQ邮箱，支持读取收件箱、发送邮件（含附件）、按主题/发件人/日期搜索邮件及列出文件夹。需配置授权码和环境变量。

buddyMe/skill_library/skills/qqmail-1.0.0/SKILL.md virgo777/buddyme

Trigger Scenarios

用户需要阅读QQ邮箱中的邮件用户希望发送带有或不带附件的电子邮件用户想要搜索特定条件的邮件用户需要查看QQ邮箱的文件夹列表

Install

npx skills add virgo777/buddyme --skill qqmail -g -y

More Options

Non-standard path

npx skills add https://github.com/virgo777/buddyme/tree/master/buddyMe/skill_library/skills/qqmail-1.0.0 -g -y

Use without installing

npx skills use virgo777/buddyme@qqmail

指定 Agent (Claude Code)

npx skills add virgo777/buddyme --skill qqmail -a claude-code -g -y

安装 repo 全部 skill

npx skills add virgo777/buddyme --all -g -y

预览 repo 内 skill

npx skills add virgo777/buddyme --list

SKILL.md

Frontmatter

{
    "name": "qqmail",
    "metadata": {
        "openclaw": {
            "os": [
                "win32",
                "linux",
                "darwin"
            ],
            "requires": {
                "bins": [
                    "python3"
                ]
            },
            "primaryEnv": "QQMAIL_AUTH_CODE"
        }
    },
    "description": "Manage QQ Mail (QQ邮箱) via IMAP\/SMTP. Use when the user wants to read, send, search, or manage emails from their QQ mailbox. Supports reading inbox, sending emails with attachments, searching by subject\/sender\/date, and listing folders."
}

QQ Mail Manager

Manage QQ邮箱 via standard IMAP/SMTP protocols using Python scripts.

Prerequisites

The user must enable IMAP/SMTP in QQ Mail settings and obtain an authorization code (授权码):

Log in to mail.qq.com → Settings (设置) → Account (账户)
Enable IMAP/SMTP service
Generate an authorization code (授权码) — this is NOT the QQ password

Configuration

The skill reads credentials from environment variables:

QQMAIL_USER — 5847713@qq.com
QQMAIL_AUTH_CODE — jyzviigffggncbbg

Available Operations

Read recent emails

python3 {baseDir}/scripts/qqmail.py inbox --limit 10

Shows: sender, subject, date, and a text preview of each email.

Read a specific email by index

python3 {baseDir}/scripts/qqmail.py read --index 1

Shows the full email content (text body).

Send an email

python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Hello" --body "Email content here"

Send with attachment

python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Report" --body "See attached" --attachment "/path/to/file.pdf"

Search emails

python3 {baseDir}/scripts/qqmail.py search --subject "keyword"
python3 {baseDir}/scripts/qqmail.py search --from "sender@example.com"
python3 {baseDir}/scripts/qqmail.py search --since "2026-01-01"
python3 {baseDir}/scripts/qqmail.py search --subject "meeting" --since "2026-02-01" --limit 5

List mail folders

python3 {baseDir}/scripts/qqmail.py folders

Read from a specific folder

python3 {baseDir}/scripts/qqmail.py inbox --folder "Sent Messages" --limit 5

Error Handling

If authentication fails: verify QQMAIL_USER and QQMAIL_AUTH_CODE are set correctly.
If IMAP is not enabled: guide the user to enable it in QQ Mail settings.
Connection errors may indicate network issues or proxy requirements.