QQ邮箱邮件发送技能 | Email Sender Skill

概述 | Overview

这是一个专为 OpenClaw AI Agent 设计的邮件自动发送和接收技能。通过 SMTP/POP3 协议实现邮件收发，支持附件、抄送等功能。

This is an email automation skill designed for OpenClaw AI Agents. It enables email sending and receiving via SMTP/POP3 protocols, with support for attachments and CC.

解决的问题 | Problem Solving

多 OpenClaw 协作痛点 | Multi-Agent Collaboration Pain Points

使用飞书的局限：

• ❌ Agent 群聊消息容易丢失
• ❌ 云文档沟通效率低，经常出现空白内容
• ❌ 消息同步不及时，无法追踪任务状态

Limitations of using Feishu (Lark):

• ❌ Group chat messages between agents are often lost
• ❌ Cloud document communication is inefficient with frequent blank content
• ❌ Message sync is not timely, making task tracking difficult

邮件协作的优势：

• ✅ 消息100%可靠传输，不会丢失
• ✅ 完整的对话历史记录，便于追溯
• ✅ 支持附件传输，方便文件共享
• ✅ 跨平台兼容，任何邮件客户端都能接收

Advantages of Email Collaboration:

• ✅ 100% reliable message delivery, never lost
• ✅ Complete conversation history for easy tracking
• ✅ Supports file attachments for easy sharing
• ✅ Cross-platform compatibility, works with any email client

核心功能 | Core Features

使用场景 | Use Cases

1. 多 Agent 任务协作 | Multi-Agent Task Collaboration

# Agent A 完成任务后通知 Agent B
send_email(
    to="agent_b@company.com",
    subject="任务完成: 数据分析",
    body="已完成数据分析，结果见附件"
)

2. 定时报告推送 | Scheduled Report Delivery

# 每日自动发送报告
send_email(
    to="team@company.com", 
    subject="每日工作报告",
    attachment="/path/to/report.pdf"
)

3. 跨平台文件传输 | Cross-Platform File Transfer

# 文件在不同设备间传输
send_email(
    to="another_device@email.com",
    attachment="/large/file.zip"
)

技术配置 | Technical Configuration

QQ邮箱配置 | QQ Mail Configuration

获取授权码 | Get Authorization Code

1. 登录 mail.qq.com
2. 进入设置 → 账户
3. 开启 POP3/SMTP 服务
4. 获取授权码

安装依赖 | Installation

pip install python-docx

示例代码 | Sample Code

发送简单邮件 | Send Simple Email

import smtplib
import ssl
from email.mime.text import MIMEText

smtp_server = "smtp.qq.com"
smtp_port = 465
username = "your@qq.com"
password = "授权码"

msg = MIMEText("邮件内容", "plain", "utf-8")
msg["Subject"] = "邮件标题"
msg["From"] = username
msg["To"] = "receiver@example.com"

ctx = ssl.create_default_context()
with smtplib.SMTP_SSL(smtp_server, smtp_port, context=ctx) as server:
    server.login(username, password)
    server.send_message(msg)

发送带附件的邮件 | Send Email with Attachment

import smtplib
import ssl
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders

msg = MIMEMultipart()
msg["From"] = username
msg["To"] = "receiver@example.com"
msg["Subject"] = "带附件的邮件"

msg.attach(MIMEText("邮件正文", "plain", "utf-8"))

# 添加附件
with open("file.pdf", "rb") as f:
    part = MIMEBase("application", "pdf")
    part.set_payload(f.read())
    encoders.encode_base64(part)
    part.add_header("Content-Disposition", "attachment", filename="file.pdf")
    msg.attach(part)

ctx = ssl.create_default_context()
with smtplib.SMTP_SSL(smtp_server, smtp_port, context=ctx) as server:
    server.login(username, password)
    server.send_message(msg)

接收邮件 | Receive Email

import poplib
import ssl

pop_server = "pop.qq.com"
pop_port = 995
username = "your@qq.com"
password = "授权码"

ctx = ssl.create_default_context()
server = poplib.POP3_SSL(pop_server, pop_port, context=ctx)
server.user(username)
server.pass_(password)

# 获取邮件数量
num = len(server.list()[1])
print(f"收件箱: {num} 封邮件")

# 获取最新邮件
msg = server.retr(num)[1]
server.quit()

适用人群 | Target Users

• 🤖 使用 OpenClaw 的 AI Agent 开发者
• 👥 需要多 Agent 协作的团队
• 📧 需要可靠消息传递的场景
• 📁 需要传输大文件的用户

版本 | Version

• v1.0.0 - 初始版本 | Initial version

作者 | Author

OpenClaw Community

许可 | License

MIT License