Simple Email

# Simple Email - 简单易用的邮件技能

通过 IMAP 协议接收和管理邮件，通过 SMTP 协议发送邮件。支持所有标准 IMAP/SMTP 邮件服务，包括 Gmail、QQ 邮箱、163、新浪、Outlook 等。

🚀 快速开始

1. 安装依赖

```bash cd skills/simple-email npm install ```

2. 配置邮箱

复制配置模板并填写你的邮箱信息：

```bash cp .env.example .env ```

编辑 `.env` 文件，填入你的邮箱配置：

```bash # IMAP 配置（接收邮件） IMAP_HOST=imap.sina.cn IMAP_PORT=993 [email protected] IMAP_PASS=your_password_or_auth_code IMAP_TLS=true

# SMTP 配置（发送邮件） SMTP_HOST=smtp.sina.cn SMTP_PORT=465 SMTP_SECURE=true [email protected] SMTP_PASS=your_password_or_auth_code SMTP_FROM=小智助理 <[email protected]>

# 安全配置（文件读写权限） ALLOWED_READ_DIRS=C:\Users\Administrator\.openclaw\workspace ALLOWED_WRITE_DIRS=C:\Users\Administrator\.openclaw\workspace ```

3. 测试连接

```bash # 测试 SMTP 发送 node scripts/smtp.js test

# 检查收件箱 node scripts/imap.js check --limit 5 ```

---

📥 接收邮件（IMAP）

检查新邮件

```bash # 检查最新 10 封邮件 node scripts/imap.js check

# 检查最新 5 封邮件 node scripts/imap.js check --limit 5

# 只检查未读邮件 node scripts/imap.js check --unseen

# 检查最近 2 小时的邮件 node scripts/imap.js check --recent 2h

# 检查指定邮箱 node scripts/imap.js check --mailbox INBOX ```

搜索邮件

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

# 按发件人搜索 node scripts/imap.js search --from "[email protected]"

# 按主题搜索 node scripts/imap.js search --subject "报告"

# 搜索最近 7 天的邮件 node scripts/imap.js search --recent 7d

# 组合搜索 node scripts/imap.js search --unseen --from "[email protected]" --limit 10 ```

查看邮件详情

```bash # 查看指定 UID 的邮件 node scripts/imap.js fetch <uid> ```

标记已读/未读

```bash # 标记为已读 node scripts/imap.js mark-read <uid1> <uid2> ...

# 标记为未读 node scripts/imap.js mark-unread <uid1> <uid2> ... ```

下载附件

```bash # 下载邮件的所有附件 node scripts/imap.js download <uid>

# 下载到指定目录 node scripts/imap.js download <uid> --dir ./attachments

# 下载指定附件 node scripts/imap.js download <uid> --file report.pdf ```

列出所有邮箱

```bash node scripts/imap.js list-mailboxes ```

---

📤 发送邮件（SMTP）

发送纯文本邮件

```bash node scripts/smtp.js send --to [email protected] --subject "你好" --body "这是一封测试邮件" ```

发送 HTML 邮件

```bash node scripts/smtp.js send --to [email protected] --subject "HTML 邮件" --html --body "<h1>你好</h1><p>这是<strong>HTML</strong>格式的邮件</p>" ```

发送带附件的邮件

```bash node scripts/smtp.js send --to [email protected] --subject "报告" --body "请查收附件" --attach ./report.pdf ```

发送给多人

```bash # 多个收件人 node scripts/smtp.js send --to "[email protected],[email protected]" --subject "通知" --body "大家好"

# 抄送 node scripts/smtp.js send --to [email protected] --cc "[email protected],[email protected]" --subject "抄送" --body "你好"

# 密送 node scripts/smtp.js send --to [email protected] --bcc "[email protected]" --subject "密送" --body "你好" ```

从文件读取内容

```bash # 从文件读取邮件正文 node scripts/smtp.js send --to [email protected] --subject "报告" --body-file ./message.txt

# 从文件读取 HTML 内容 node scripts/smtp.js send --to [email protected] --subject "新闻稿" --html --html-file ./newsletter.html

# 从文件读取主题 node scripts/smtp.js send --to [email protected] --subject-file ./subject.txt --body-file ./body.txt ```

---

📋 常用邮箱服务器配置

| 服务商 | IMAP 主机 | IMAP 端口 | SMTP 主机 | SMTP 端口 | 说明 | |--------|-----------|-----------|-----------|-----------|------| | 新浪邮箱 | imap.sina.cn | 993 | smtp.sina.cn | 465 | 使用授权码 | | QQ 邮箱 | imap.qq.com | 993 | smtp.qq.com | 587 | 使用授权码 | | 163 邮箱 | imap.163.com | 993 | smtp.163.com | 465 | 使用授权码 | | 126 邮箱 | imap.126.com | 993 | smtp.126.com | 465 | 使用授权码 | | Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 | 使用应用专用密码 | | Outlook | outlook.office365.com | 993 | smtp.office365.com | 587 | 使用应用密码 |

---

⚠️ 重要提示

Gmail 用户 - Gmail **不接受**常规账户密码 - 必须生成 **应用专用密码**：https://myaccount.google.com/apppasswords - 需要启用两步验证

163/QQ/新浪邮箱用户 - 使用 **授权码**，不是账户密码 - 需要在网页版邮箱设置中先启用 IMAP/SMTP 服务 - 授权码在邮箱设置 → 账户安全中获取

---

🔒 安全建议

1. 不要提交 `.env` 文件到版本控制系统
2. 使用授权码/应用密码，而不是账户密码
3. 启用 SSL/TLS 加密连接
4. 定期更换密码
5. 限制 `ALLOWED_READ_DIRS` 和 `ALLOWED_WRITE_DIRS` 到必要的目录

---

🐛 常见问题

认证失败 - 检查用户名是否为完整邮箱地址 - 确认使用授权码/应用密码，而非账户密码 - 检查是否已启用 IMAP/SMTP 服务

连接超时 - 检查服务器地址和端口是否正确 - 确认网络连接正常 - 检查防火墙设置

TLS/SSL 错误 - 确认 `IMAP_TLS` 和 `SMTP_SECURE` 设置正确 - 自签名证书可设置 `IMAP_REJECT_UNAUTHORIZED=false`

---

📝 命令速查

IMAP 命令 ```bash node scripts/imap.js check [--limit N] [--unseen] [--recent 2h] node scripts/imap.js search [--unseen] [--from xxx] [--subject xxx] node scripts/imap.js fetch <uid> node scripts/imap.js mark-read <uid> [uid2 ...] node scripts/imap.js mark-unread <uid> [uid2 ...] node scripts/imap.js download <uid> [--dir ./path] node scripts/imap.js list-mailboxes ```

SMTP 命令 ```bash node scripts/smtp.js send --to <email> --subject <text> --body <text> node scripts/smtp.js send --to <email> --subject <text> --html --body "<html>..." node scripts/smtp.js send --to <email> --subject <text> --attach <file> node scripts/smtp.js test ```

---

📄 许可证

MIT License