QQ邮箱读取和发送
通过 IMAP 协议读取 QQ 邮箱邮件
触发条件
用户提到以下场景时使用：
- "查看邮箱"
- "读取邮件"
- "查看最近邮件"
- "查看当天邮件"
- "搜索邮件"
- "有新的邮件吗"
配置
需要提前配置QQ 邮箱 IMAP：
- 在 QQ 邮箱设置中开启 IMAP 服务
- 创建授权码（不是登录密码）
- 配置 secrets 文件：
~/.openclaw/secrets/mail_qq.envMAIL_USER=your_email@qq.com MAIL_PASS=your_auth_code
安全注意事项
- 凭据文件必须设置权限为
600（仅所有者可读），防止其他用户读取敏感信息 ~/.openclaw/secrets/目录默认已经加入.gitignore，不会被提交到版本控制- 不要将授权码提交到代码仓库或分享给他人
使用方法
1. 连接邮箱
import imaplib
import email
from email.header import decode_header
IMAP_HOST = 'imap.qq.com'
IMAP_PORT = 993
def connect_mail(user, password):
mail = imaplib.IMAP4_SSL(IMAP_HOST, IMAP_PORT)
mail.login(user, password)
mail.select('INBOX')
return mail
2. 搜索邮件
# 搜索最近7天的邮件
week_ago = (datetime.now() - timedelta(days=7)).strftime('%d-%b-%Y')
typ, msg_ids = mail.search(None, f'SINCE {week_ago}')
3. 解析邮件
def decode_header_value(header_value):
"""兼容多种编码的解码"""
if not header_value:
return ""
decoded_parts = []
for content, encoding in decode_header(header_value):
if isinstance(content, bytes):
try:
decoded = content.decode(encoding if encoding else 'utf-8')
except:
# 尝试其他常见编码
for enc in ['gbk', 'gb2312', 'utf-8', 'big5', 'latin1']:
try:
decoded = content.decode(enc)
break
except:
decoded = content.decode('utf-8', errors='ignore')
else:
decoded = str(content)
decoded_parts.append(decoded)
return ''.join(decoded_parts)
4. 提取正文
邮件正文可能包含 HTML，需要清理：
import re
def get_text_body(msg):
body = ''
if msg.is_multipart():
for part in msg.walk():
if part.get_content_type() == 'text/html':
payload = part.get_payload(decode=True)
encoding = part.get_content_charset() or 'utf-8'
body = payload.decode(encoding, errors='ignore')
break
else:
payload = msg.get_payload(decode=True)
encoding = msg.get_content_charset() or 'utf-8'
body = payload.decode(encoding, errors='ignore')
# 清理HTML标签
text = re.sub(r'<[^>]+>', ' ', body)
text = text.replace(' ', ' ')
text = text.replace('&', '&')
text = re.sub(r'\s+', ' ', text)
return text
邮件过滤
根据用户需求过滤邮件，常见关键词类型：
- 通知类：通知、提醒、公告
- 业务类：订单、发货、支付
- 职位类：面试、邀请、邀约（仅当用户明确需要时）
注意事项
- QQ 邮箱必须使用授权码登录，非登录密码
- 邮件编码可能为GBK/GB2312/UTF-8 等，需要多种编码尝试
- IMAP 搜索不支持中文，使用 SINCE 获取所有邮件后本地过滤
发送邮件
通过 QQ 邮箱 SMTP 服务发送邮件，使用相同的授权码进行认证
配置
发送邮件使用与读取邮件相同的凭据文件 ~/.openclaw/secrets/mail_qq.env
MAIL_USER=your_email@qq.com
MAIL_PASS=your_auth_code
SMTP 设置
- 主机为
smtp.qq.com - 端口为 465 (SSL) 或 587 (STARTTLS)
- 授权码： 与 IMAP 相同的授权码（非登录密码）
使用方法
1. 使用 Python 模块发送邮件
新建 qq_mail_sender.py 模块提供了发送邮件的功能
from qq_mail_sender import send_email
send_email(
to="recipient@example.com",
subject="测试邮件主题",
body="这是一封测试邮件正文"
)
2. 命令行方式
python qq_mail_sender.py recipient@example.com "测试邮件主题" "这是一封测试邮件正文"
3. 详细代码示例（在 qq_mail_sender.py 中）
import smtplib
import ssl
from email.message import EmailMessage
from email.header import Header
import os
def load_credentials(env_path=r"C:\Users\Administrator\.openclaw\secrets\mail_qq.env"):
"""从env文件加载MAIL_USER和MAIL_PASS"""
creds = {}
if os.path.exists(env_path):
with open(env_path, 'r') as f:
for line in f:
line = line.strip()
if line and not line.startswith('#'):
if '=' in line:
k, v = line.split('=', 1)
creds[k.strip()] = v.strip()
return creds
def build_message(sender, to, subject, body, cc=None, bcc=None):
"""构建带有适当编码的EmailMessage"""
msg = EmailMessage()
msg['From'] = sender
msg['To'] = to
if cc:
msg['Cc'] = cc
if bcc:
msg['Bcc'] = bcc
msg['Subject'] = Header(subject, 'utf-8')
msg.set_content(body, charset='utf-8')
return msg
def send_email(to, subject, body, cc=None, bcc=None):
"""
通过QQ SMTP发送邮件
使用SSL连接端口465
"""
creds = load_credentials()
user = creds.get('MAIL_USER')
password = creds.get('MAIL_PASS')
if not user or not password:
raise ValueError("凭据文件中缺少MAIL_USER或MAIL_PASS")
msg = build_message(user, to, subject, body, cc, bcc)
context = ssl.create_default_context()
with smtplib.SMTP_SSL('smtp.qq.com', 465, context=context) as server:
server.login(user, password)
server.send_message(msg)
print(f"邮件已发送至 {to}")
安全注意事项
- 凭据文件必须设置权限为
600（仅所有者可读），防止其他用户读取敏感信息 ~/.openclaw/secrets/目录默认已经加入.gitignore，不会被提交到版本控制- 不要将授权码提交到代码仓库或分享给他人
- 建议先用少量收件人进行测试
参考文档
详细的发送邮件参考请参见：references/message-sending.md