邮件收发管理

技能简介

基于IMAP/SMTP协议的邮件处理工具，支持读取、搜索、管理收件箱，以及发送带附件的邮件。兼容Gmail、Outlook、163.com、126.com、188.com等主流邮箱服务。

能做什么

• 检查新邮件和未读邮件
• 按发件人、主题、时间等条件搜索邮件
• 获取邮件完整内容和元数据
• 下载邮件附件到本地
• 标记邮件已读/未读状态
• 列出所有邮箱文件夹
• 发送纯文本或HTML格式邮件
• 发送带多个附件的邮件

使用说明

安装配置

1. 克隆技能仓库到本地目录
2. 在技能文件夹创建.env文件，配置以下环境变量：

# IMAP配置（接收邮件）
IMAP_HOST=imap.gmail.com
IMAP_PORT=993
IMAP_USER=your@email.com
IMAP_PASS=your_password
IMAP_TLS=true
IMAP_REJECT_UNAUTHORIZED=true
IMAP_MAILBOX=INBOX

# SMTP配置（发送邮件）
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your@gmail.com
SMTP_PASS=your_password
SMTP_FROM=your@gmail.com
SMTP_REJECT_UNAUTHORIZED=true

常用命令示例

# 检查新邮件（最近2小时，最多10封）
node scripts/imap.js check --recent 2h --limit 10

# 搜索未读邮件
node scripts/imap.js search --unseen --limit 20

# 获取指定UID邮件内容
node scripts/imap.js fetch 12345

# 下载邮件所有附件
node scripts/imap.js download 12345 --dir ./attachments

# 发送简单邮件
node scripts/smtp.js send --to recipient@example.com --subject "Hello" --body "World"

# 发送带附件的HTML邮件
node scripts/smtp.js send --to recipient@example.com --subject "Report" --html --body-file content.html --attach report.pdf,data.xlsx

网易邮箱特殊配置

163.com、126.com、188.com及其VIP版本需使用授权码替代账户密码，并先在网页端开启IMAP/SMTP服务。

输入与输出

见下方输入与输出表格。

风险提示

• 密码和授权码以明文形式存储在环境变量中，注意文件权限保护
• 使用自签名证书时需将REJECT_UNAUTHORIZED设为false，存在中间人攻击风险
• 频繁操作可能触发邮箱服务商的安全限制
• 下载附件前建议检查文件类型和大小，避免恶意文件
• Gmail等邮箱可能需要开启”不够安全的应用访问”或使用应用专用密码

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gzlicanyi/imap-smtp-email/SKILL.md
来源类型：开源社区技能