Email Sender

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

| 功能 | Feature | 说明 | |------|---------|------| | 发送邮件 | Send Email | 支持纯文本、HTML格式 | | 附件发送 | Attachments | 支持PDF、图片、文档等 | | 抄送功能 | CC/BCC | 支持多人抄送 | | 邮件接收 | Receive Email | 定时检查收件箱 | | 自动回复 | Auto Reply | 可配置自动回复规则 |

---

使用场景 | 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

| 配置项 | Config | 值 | Value | |--------|--------|-----|-------| | SMTP服务器 | SMTP Server | smtp.qq.com | | | SMTP端口 | SMTP Port | 465 (SSL) / 587 (TLS) | | | POP3服务器 | POP3 Server | pop.qq.com | | | POP3端口 | POP3 Port | 995 (SSL) | | | 用户名 | Username | your@qq.com | | | 密码 | Password | 授权码（非QQ密码）| |

获取授权码 | 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