邮件管理器 Lite v0.2

一款为OpenClaw设计的完全独立的邮件管理技能。使用标准IMAP和SMTP协议，无任何外部依赖。

✨ v0.2 版本新功能

🔍 高级搜索与筛选

• 按发件人搜索 (--from)
• 按主题关键词搜索 (--subject)
• 按日期范围筛选 (--since,--before)
• 按已读/未读状态筛选 (--seen,--unseen)
• 在邮件正文中搜索 (--body, 警告：可能较慢)

📁 文件夹管理

• 列出所有IMAP文件夹，使用folders命令
• 使用以下命令在文件夹间移动邮件move命令
• 自动验证文件夹是否存在

📎 附件信息

• 自动检测附件
• 显示附件详情：
  • 文件名
  • MIME类型
  • 文件大小（格式化为KB/MB）
• 在以下两种情况中均显示read和search结果

🔧 安装

cd skills/portable-email-manager
npm install

依赖项已捆绑在package.json中：

• nodemailer- SMTP邮件发送
• imap-simple- IMAP操作
• 邮件解析器- 邮件解析和附件检测

🔐 凭据

设置以下环境变量：

export EMAIL_USER="your.email@domain.com"
export EMAIL_PASS="your-app-password"

推荐：对于Gmail、Outlook、Zoho，请使用应用专用密码而非主密码。

服务提供商设置

Zoho Mail（默认）：

• 已配置为smtp.zoho.eu和imap.zoho.eu
• 生成应用专用密码：https://accounts.zoho.eu/home#security/apppasswords

Gmail：

• 编辑scripts/email.js并更改：

  host: 'smtp.gmail.com'  // SMTP
  host: 'imap.gmail.com'  // IMAP
  

• 启用双重认证并创建应用专用密码：https://myaccount.google.com/apppasswords

Outlook/Hotmail：

• 编辑以使用smtp.office365.com/outlook.office365.com
• SMTP端口587（使用TLS）

📖 使用说明

发送邮件

./scripts/email.js send "recipient@example.com" "Subject" "Email body text"

示例：

./scripts/email.js send "boss@company.com" "Weekly Report" "Attached is this week's summary."

读取最近邮件

./scripts/email.js read [limit]

示例：

# Read last 5 emails (default)
./scripts/email.js read

# Read last 20 emails
./scripts/email.js read 20

输出包含：

• UID（用于移动邮件的唯一标识符）
• 发件人/收件人地址
• 主题和日期
• 附件数量及详情
• 邮件正文预览（前500个字符）

高级搜索

./scripts/email.js search [options]

搜索选项：

示例：

# Find unread emails from specific sender
./scripts/email.js search --from "client@example.com" --unseen

# Search by subject
./scripts/email.js search --subject "invoice" --limit 5

# Date range search
./scripts/email.js search --since "Jan 15, 2026" --before "Feb 1, 2026"

# Search in body (use sparingly - can be slow)
./scripts/email.js search --body "quarterly review"

# Combine multiple filters
./scripts/email.js search --from "boss@company.com" --subject "urgent" --unseen --limit 3

列出文件夹

./scripts/email.js folders

显示所有IMAP文件夹的层次结构树及其属性。

示例输出：

📁 INBOX
📁 Sent
📁 Archive
📁 Drafts
📁 Spam
📁 Trash

将邮件移至文件夹

./scripts/email.js move <uid> <folder-name>

重要提示：

• 获取用户ID来自读取或搜索输出
• 文件夹名称区分大小写
• 脚本在移动前会验证文件夹是否存在

示例：

# First, find the email and note its UID
./scripts/email.js search --from "newsletter@example.com"
# Output shows: UID: 12345

# Move to Archive folder
./scripts/email.js move 12345 "Archive"

# Move to custom folder
./scripts/email.js move 67890 "Projects/Work"

错误处理：

• 如果文件夹不存在，会显示可用文件夹列表
• 尝试移动前验证用户ID是否存在

帮助

./scripts/email.js help

显示包含所有命令和示例的完整使用指南。

🎯 使用场景

日常邮件处理

# Check unread emails
./scripts/email.js search --unseen --limit 10

# Move newsletters to folder
./scripts/email.js search --from "newsletter@site.com" --limit 1
./scripts/email.js move <uid> "Newsletters"

查找特定邮件

# Search by sender and subject
./scripts/email.js search --from "client@example.com" --subject "proposal"

# Search by date
./scripts/email.js search --since "Jan 20, 2026" --subject "meeting notes"

归档旧邮件

# Find old read emails
./scripts/email.js search --before "Dec 1, 2025" --seen --limit 50

# Move each to Archive (use UID from output)
./scripts/email.js move <uid> "Archive"

检查附件

# Read recent emails and see attachment info
./scripts/email.js read 10

# Search output automatically shows:
# - Number of attachments
# - Filename, type, and size for each

🔒 安全性

• 凭据从不记录或存储在文件中
• 所有连接均使用TLS/SSL加密
• 推荐使用应用专用密码而非账户密码
• 除IMAP/SMTP连接外，无数据离开您的设备

⚙️ 配置

默认配置针对Zoho Mail欧洲版进行了优化

如需使用其他提供商，请编辑scripts/email.js文件：

// SMTP Configuration
const smtpConfig = {
  host: 'smtp.your-provider.com',
  port: 465,  // or 587 for TLS
  secure: true,  // true for SSL (465), false for TLS (587)
  auth: {
    user: EMAIL_USER,
    pass: EMAIL_PASS
  }
};

// IMAP Configuration
const imapConfig = {
  imap: {
    user: EMAIL_USER,
    password: EMAIL_PASS,
    host: 'imap.your-provider.com',
    port: 993,
    tls: true,
    authTimeout: 20000
  }
};

🚀 性能说明

• 邮件正文搜索（--body参数）在大型邮箱中可能较慢——请谨慎使用
• 主题/发件人搜索速度较快——使用IMAP服务器端筛选
• 日期筛选器效率较高
• 使用--limit参数限制结果数量以加快响应

🐛 故障排除

"身份验证失败"

• 验证 EMAIL_USER 和 EMAIL_PASS 是否正确设置
• 使用应用专用密码，而非账户密码
• 检查邮件服务商的设置（双因素认证、低安全性应用访问权限等）

"找不到文件夹"

• 使用folders命令查看确切的文件夹名称
• 文件夹名称区分大小写
• 部分服务商使用不同的名称（例如，"已发送邮件" 与 "Sent"）

"连接超时"

• 检查防火墙/网络设置
• 确认 IMAP/SMTP 端口可访问
• 尝试在配置中增加authTimeout的值

"未找到邮件"

• 检查搜索条件
• 确认邮件存在于收件箱（而非其他文件夹中）
• 尝试更宽泛的搜索（移除部分筛选条件）

📝 版本历史

v0.2.0 （当前版本）

• ✨ 支持多筛选条件的高级搜索
• 📁 文件夹管理（列表、移动）
• 📎 附件检测与信息查看
• 🎨 优化的输出格式
• 📚 全面的使用文档

v0.1.0

• 基础的邮件发送/读取功能
• 支持 Zoho Mail
• IMAP/SMTP 基础框架

🤝 兼容性

已测试：

• ✅ Zoho Mail（欧盟区与美国区）
• ✅ Gmail
• ✅ Outlook/Hotmail
• ✅ iCloud Mail
• ✅ 自定义 IMAP/SMTP 服务器

💡 使用提示

1. 自动化时使用UID：保存搜索结果中的UID，以便通过编程方式移动邮件
2. 组合筛选条件：多个筛选条件将创建“与”关系，实现精确搜索
3. 文件夹整理：首先列出文件夹以规划您的组织策略
4. 日期格式：使用自然语言日期，例如“2026年1月1日”或“2025年12月25日”
5. 附件筛选：在搜索结果中查找“附件：X”以找到带有文件的电子邮件

📄 许可证

ISC - 可在您的OpenClaw设置中自由使用