qq-email

QQ 邮箱智能管理工具。支持收发邮件、搜索筛选、附件处理，以及 AI 智能整理功能（自动摘要、分类、优先级排序、待办提取）。当用户需要操作 QQ 邮箱、查收邮件、发送邮件、整理收件箱或处理邮件相关任务时使用此技能。

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "qq-email" with this command: npx skills add qq-email-ai

QQ 邮箱智能助手

功能概览

本技能提供完整的 QQ 邮箱管理能力，结合 AI 智能整理功能：

功能说明
📥 收件管理读取收件箱、未读邮件、指定文件夹
✉️ 发送邮件发送纯文本/HTML 邮件，支持附件
🔍 智能搜索按关键词、发件人、时间、主题搜索
🗂️ 邮件管理标记已读/未读、删除、移动、归档
📎 附件处理下载附件、发送附件
🤖 AI 整理自动摘要、智能分类、优先级排序、待办提取

快速开始

配置邮箱账号

首次使用需要配置 QQ 邮箱的 IMAP/SMTP 授权码：

  1. 登录 QQ 邮箱网页版
  2. 设置 → 账户 → 开启 IMAP/SMTP 服务
  3. 获取 授权码（不是登录密码）
  4. 配置环境变量或配置文件

环境变量配置

export QQ_EMAIL="your_qq@qq.com"
export QQ_EMAIL_AUTH_CODE="your_auth_code"  # 16位授权码

核心功能

1. 读取邮件

读取最新邮件：

# 读取收件箱最新 10 封邮件
python scripts/fetch_emails.py --limit 10

# 读取未读邮件
python scripts/fetch_emails.py --unread

# 读取指定文件夹
python scripts/fetch_emails.py --folder "Sent Messages" --limit 5

输出格式：

{
  "emails": [
    {
      "id": "msg_001",
      "subject": "会议通知",
      "sender": "boss@company.com",
      "date": "2024-03-19 14:30:00",
      "body_text": "邮件正文...",
      "body_html": "<html>...</html>",
      "attachments": ["report.pdf"],
      "flags": ["\\Seen"]
    }
  ]
}

2. 发送邮件

发送纯文本邮件：

python scripts/send_email.py \
  --to "recipient@example.com" \
  --subject "测试邮件" \
  --body "这是一封测试邮件"

发送带附件邮件：

python scripts/send_email.py \
  --to "recipient@example.com" \
  --cc "cc@example.com" \
  --subject "报告附件" \
  --body "请查收附件" \
  --attachments "/path/to/report.pdf,/path/to/data.xlsx"

发送 HTML 邮件：

python scripts/send_email.py \
  --to "recipient@example.com" \
  --subject "HTML 邮件" \
  --html "<h1>标题</h1><p>内容</p>"

3. 搜索邮件

基础搜索：

# 按关键词搜索主题和内容
python scripts/search_emails.py --query "项目进度"

# 按发件人搜索
python scripts/search_emails.py --from "boss@company.com"

# 按时间范围搜索
python scripts/search_emails.py --since "2024-03-01" --before "2024-03-20"

# 组合条件
python scripts/search_emails.py \
  --query "合同" \
  --from "legal@company.com" \
  --unread

4. 邮件管理

标记和移动：

# 标记已读
python scripts/manage_email.py --id "msg_001" --action mark_read

# 标记未读
python scripts/manage_email.py --id "msg_001" --action mark_unread

# 删除邮件
python scripts/manage_email.py --id "msg_001" --action delete

# 移动到文件夹
python scripts/manage_email.py --id "msg_001" --action move --folder "Archive"

# 批量操作（逗号分隔 ID）
python scripts/manage_email.py --id "msg_001,msg_002,msg_003" --action mark_read

5. 附件处理

下载附件：

# 下载邮件的所有附件
python scripts/download_attachments.py \
  --email-id "msg_001" \
  --output-dir "./downloads"

# 下载指定附件
python scripts/download_attachments.py \
  --email-id "msg_001" \
  --filename "report.pdf" \
  --output-path "./downloads/report.pdf"

AI 智能整理

自动摘要

为每封邮件生成简洁摘要：

python scripts/ai_summarize.py --limit 20

输出示例：

{
  "summary": {
    "total": 20,
    "processed": 20,
    "results": [
      {
        "id": "msg_001",
        "subject": "Q1 季度总结会议通知",
        "summary": "3月25日下午2点召开Q1总结会议，需准备部门汇报PPT，地点：会议室A",
        "key_points": ["时间：3月25日 14:00", "需准备PPT", "地点：会议室A"]
      }
    ]
  }
}

智能分类

自动将邮件分类到不同类别：

# 分类最新邮件
python scripts/ai_classify.py --limit 50

# 分类指定邮件
python scripts/ai_classify.py --email-ids "msg_001,msg_002"

分类类别：

  • work - 工作相关
  • promotion - 推广/营销
  • social - 社交/通知
  • important - 重要邮件
  • newsletter - 订阅邮件
  • spam - 垃圾邮件

输出示例：

{
  "classifications": [
    {
      "id": "msg_001",
      "category": "work",
      "confidence": 0.95,
      "reason": "包含会议通知、工作安排等关键词"
    },
    {
      "id": "msg_002", 
      "category": "promotion",
      "confidence": 0.88,
      "reason": "来自电商平台，包含优惠信息"
    }
  ]
}

优先级排序

根据内容和发件人智能排序邮件优先级：

python scripts/ai_prioritize.py --limit 30

优先级等级：

  • urgent - 紧急（需立即处理）
  • high - 高优先级（24小时内处理）
  • medium - 中优先级（本周处理）
  • low - 低优先级（可延后）

待办事项提取

从邮件中提取待办任务：

python scripts/ai_extract_todos.py --limit 50

输出示例：

{
  "todos": [
    {
      "email_id": "msg_001",
      "subject": "项目进度汇报",
      "todos": [
        {
          "task": "完成项目进度报告",
          "deadline": "2024-03-22",
          "priority": "high"
        },
        {
          "task": "准备周五汇报PPT",
          "deadline": "2024-03-24",
          "priority": "medium"
        }
      ]
    }
  ]
}

一键智能整理

执行完整的 AI 整理流程：

python scripts/ai_organize.py --limit 50

此命令会依次执行：

  1. 读取最新邮件
  2. 生成摘要
  3. 智能分类
  4. 优先级排序
  5. 提取待办事项
  6. 生成整理报告

工作流示例

场景 1：早晨快速处理邮件

# 1. 获取未读邮件并生成摘要
python scripts/ai_summarize.py --unread

# 2. 提取待办事项
python scripts/ai_extract_todos.py --unread

# 3. 标记已处理的不重要邮件
python scripts/manage_email.py --id "msg_003,msg_004" --action mark_read

场景 2：周末清理收件箱

# 1. 智能分类所有邮件
python scripts/ai_classify.py --limit 100

# 2. 批量删除推广邮件（根据分类结果）
python scripts/manage_email.py --id "msg_005,msg_006" --action delete

# 3. 归档已处理的旧邮件
python scripts/manage_email.py --id "msg_007,msg_008" --action move --folder "Archive"

场景 3：查找重要邮件

# 1. 搜索老板发来的未读邮件
python scripts/search_emails.py --from "boss@company.com" --unread

# 2. 对搜索结果进行优先级排序
python scripts/ai_prioritize.py --email-ids "msg_010,msg_011"

文件夹说明

QQ 邮箱标准文件夹名称：

文件夹说明
INBOX收件箱
Sent Messages已发送
Drafts草稿箱
Deleted Messages已删除
Junk垃圾箱
Archive归档（需手动创建）

常见问题

Q: 连接失败怎么办？

  • 确认已开启 QQ 邮箱 IMAP/SMTP 服务
  • 检查使用的是授权码而非登录密码
  • 确认网络可以访问 imap.qq.com:993 和 smtp.qq.com:465

Q: 中文显示乱码？

  • 脚本已自动处理 UTF-8 编码，如遇乱码请检查终端编码设置

Q: 附件大小限制？

  • QQ 邮箱普通附件最大 50MB
  • 超大附件最大 3GB（通过中转站）

参考资料

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

Huo15 Openclaw Enhance

火一五·克劳德·龙虾增强插件 v5.7.8 — 全面适配 openclaw 2026.4.24：peerDep ^4.24 + build/compat 同步到 4.24 + 14 处 api.on 全部去掉 as any 改成 typed hook（hookName 联合类型 + handler 自动推断 Pl...

Registry SourceRecently Updated
3030zhaobod1
General

Content Trend Analyzer

Aggregates and analyzes content trends across platforms to identify hot topics, user intent, content gaps, and generates data-driven article outlines.

Registry SourceRecently Updated
260openlark
General

Prompt Debugger

Debug prompts that produce unexpected AI outputs — diagnose failure modes, identify ambiguity and conflicting instructions, test variations, compare model re...

Registry SourceRecently Updated
120charlie-morrison
General

Indie Maker News

独行者 Daily - 变现雷达。读对一条新闻，少走一年弯路。每天5分钟，给创业者装上商业雷达。聚焦一人公司、副业、创业变现资讯，智能分类，行动导向。用户下载即能用，无需本地部署！

Registry SourceRecently Updated
300kylnwu