qq-mail-read-send

读取和发送QQ邮箱邮件。使用IMAP协议读取，SMTP协议发送。支持多种编码解析。触发场景：用户要求查看邮箱、读取邮件、查看最近邮件、筛选特定邮件、发送邮件等

QQ邮箱读取和发送

通过 IMAP 协议读取 QQ 邮箱邮件

触发条件

用户提到以下场景时使用：

• "查看邮箱"
• "读取邮件"
• "查看最近邮件"
• "查看当天邮件"
• "搜索邮件"
• "有新的邮件吗"

配置

需要提前配置QQ 邮箱 IMAP：

1. 在 QQ 邮箱设置中开启 IMAP 服务
2. 创建授权码（不是登录密码）
3. 配置 secrets 文件：~/.openclaw/secrets/mail_qq.env

   MAIL_USER=[e-mail]
   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('&nbsp;', ' ')
    text = text.replace('&amp;', '&')
    text = re.sub(r'\s+', ' ', text)
    return text

邮件过滤

根据用户需求过滤邮件，常见关键词类型：

• 通知类：通知、提醒、公告
• 业务类：订单、发货、支付
• 职位类：面试、邀请、邀约（仅当用户明确需要时）

注意事项

1. QQ 邮箱必须使用授权码登录，非登录密码
2. 邮件编码可能为GBK/GB2312/UTF-8 等，需要多种编码尝试
3. IMAP 搜索不支持中文，使用 SINCE 获取所有邮件后本地过滤

发送邮件

通过 QQ 邮箱 SMTP 服务发送邮件，使用相同的授权码进行认证

配置

发送邮件使用与读取邮件相同的凭据文件 ~/.openclaw/secrets/mail_qq.env

MAIL_USER=[e-mail]
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="[e-mail]",
    subject="测试邮件主题",
    body="这是一封测试邮件正文"
)

2. 命令行方式

python qq_mail_sender.py [e-mail] "测试邮件主题" "这是一封测试邮件正文"

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