Email Manager

---
name: email-manager
description: "收发和管理邮件，支持查看未读邮件、搜索邮件、下载附件、发送带附件的邮件，并提供交互式配置向导。兼容Gmail、Outlook、163.com、126.com、QQ邮箱等主流服务商。当用户需要收发邮件、查看收件箱、搜索特定邮件、管理附件，或提及配置邮箱时触发。"
metadata:
  openclaw:
    emoji: "📧"
    requires:
      env:
        - IMAP_HOST
        - IMAP_USER
        - IMAP_PASS
        - SMTP_HOST
        - SMTP_USER
        - SMTP_PASS
      bins:
        - node
        - npm
    primaryEnv: SMTP_PASS
---

<!-- Localized from: imap-smtp-email -->

# IMAP/SMTP 邮件工具

通过 IMAP 协议收取、搜索和管理邮件，通过 SMTP 协议发送邮件。支持 Gmail、Outlook、163.com、vip.163.com、126.com、vip.126.com、188.com、vip.188.com 以及任何标准 IMAP/SMTP 服务器。

## 配置

在 skill 文件夹中创建 `.env` 文件或设置环境变量：

```bash
# IMAP 配置（接收邮件）
IMAP_HOST=imap.gmail.com          # 服务器主机名
IMAP_PORT=993                     # 服务器端口
IMAP_USER=your@email.com
IMAP_PASS=your_password
IMAP_TLS=true                     # 使用 TLS/SSL 连接
IMAP_REJECT_UNAUTHORIZED=true     # 自签名证书请设为 false
IMAP_MAILBOX=INBOX                # 默认邮箱文件夹

# SMTP 配置（发送邮件）
SMTP_HOST=smtp.gmail.com          # SMTP 服务器主机名
SMTP_PORT=587                     # SMTP 端口（587 用于 STARTTLS，465 用于 SSL）
SMTP_SECURE=false                 # SSL 用 true（465），STARTTLS 用 false（587）
SMTP_USER=your@gmail.com          # 你的邮箱地址
SMTP_PASS=your_password           # 你的密码或应用专用密码
SMTP_FROM=your@gmail.com          # 默认发件人邮箱（可选）
SMTP_REJECT_UNAUTHORIZED=true     # 自签名证书请设为 false
```

## 常用邮件服务器

| 服务商 | IMAP 主机 | IMAP 端口 | SMTP 主机 | SMTP 端口 |
|----------|-----------|-----------|-----------|-----------|
| 163.com | imap.163.com | 993 | smtp.163.com | 465 |
| vip.163.com | imap.vip.163.com | 993 | smtp.vip.163.com | 465 |
| 126.com | imap.126.com | 993 | smtp.126.com | 465 |
| vip.126.com | imap.vip.126.com | 993 | smtp.vip.126.com | 465 |
| 188.com | imap.188.com | 993 | smtp.188.com | 465 |
| vip.188.com | imap.vip.188.com | 993 | smtp.vip.188.com | 465 |
| yeah.net | imap.yeah.net | 993 | smtp.yeah.net | 465 |
| Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 |
| Outlook | outlook.office365.com | 993 | smtp.office365.com | 587 |
| QQ 邮箱 | imap.qq.com | 993 | smtp.qq.com | 587 |

**Gmail 注意事项：**
- Gmail **不接受**常规账号密码
- 你必须生成**应用专用密码**（App Password）：https://myaccount.google.com/apppasswords
- 将生成的 16 位应用专用密码用作 `IMAP_PASS` / `SMTP_PASS`
- 需要开启 Google 账号的两步验证

**163.com 注意事项：**
- 使用**授权码**，而非账号密码
- 需先在网页端设置中开启 IMAP/SMTP 服务

## IMAP 命令（收取邮件）

### check
检查新邮件/未读邮件。

```bash
node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h]
```

选项：
- `--limit <n>`：最大返回数量（默认：10）
- `--mailbox <name>`：要检查的邮箱文件夹（默认：INBOX）
- `--recent <time>`：仅显示最近一段时间内的邮件（如 30m、2h、7d）

### fetch
根据 UID 获取邮件完整内容。

```bash
node scripts/imap.js fetch <uid> [--mailbox INBOX]
```

### download
下载邮件的所有附件，或下载指定附件。

```bash
node scripts/imap.js download <uid> [--mailbox INBOX] [--dir <path>] [--file <filename>]
```

选项：
- `--mailbox <name>`：邮箱文件夹（默认：INBOX）
- `--dir <path>`：输出目录（默认：当前目录）
- `--file <filename>`：仅下载指定附件（默认：下载全部）

### search
按条件搜索邮件。

```bash
node scripts/imap.js search [options]

选项：
  --unseen           仅未读邮件
  --seen             仅已读邮件
  --from <email>     发件人包含
  --subject <text>   主题包含
  --recent <time>    最近一段时间内（如 30m、2h、7d）
  --since <date>     该日期之后（YYYY-MM-DD）
  --before <date>    该日期之前（YYYY-MM-DD）
  --limit <n>        最大结果数（默认：20）
  --mailbox <name>   要搜索的邮箱文件夹（默认：INBOX）
```

### mark-read / mark-unread
将邮件标记为已读或未读。

```bash
node scripts/imap.js mark-read <uid> [uid2 uid3...]
node scripts/imap.js mark-unread <uid> [uid2 uid3...]
```

### list-mailboxes
列出所有可用的邮箱文件夹。

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

## SMTP 命令（发送邮件）

### send
通过 SMTP 发送邮件。

```bash
node scripts/smtp.js send --to <email> --subject <text> [options]
```

**必填参数：**
- `--to <email>`：收件人（多个收件人用逗号分隔）
- `--subject <text>`：邮件主题，或使用 `--subject-file <file>`

**可选参数：**
- `--body <text>`：纯文本正文
- `--html`：以 HTML 格式发送正文
- `--body-file <file>`：从文件读取正文
- `--html-file <file>`：从文件读取 HTML 内容
- `--cc <email>`：抄送收件人
- `--bcc <email>`：密送收件人
- `--attach <file>`：附件（多个用逗号分隔）
- `--from <email>`：覆盖默认发件人

**示例：**
```bash
# 发送简单文本邮件
node scripts/smtp.js send --to recipient@example.com --subject "Hello" --body "World"

# 发送 HTML 邮件
node scripts/smtp.js send --to recipient@example.com --subject "Newsletter" --html --body "<h1>Welcome</h1>"

# 带附件的邮件
node scripts/smtp.js send --to recipient@example.com --subject "Report" --body "Please find attached" --attach report.pdf

# 多个收件人
node scripts/smtp.js send --to "a@example.com,b@example.com" --cc "c@example.com" --subject "Update" --body "Team update"
```

### test
测试 SMTP 连接，向自己发送一封测试邮件。

```bash
node scripts/smtp.js test
```

## 依赖安装

```bash
npm install
```

## 安全注意事项

- 将凭据存储在 `.env` 文件中（并添加到 `.gitignore`）
- **Gmail**：不支持常规密码登录——请在 https://myaccount.google.com/apppasswords 生成应用专用密码
- **163.com**：使用授权码，而非账号密码

## 常见问题排查

**连接超时：**
- 确认服务器正在运行且可访问
- 检查主机名和端口配置是否正确

**认证失败：**
- 确认用户名是否正确（通常为完整邮箱地址）
- 检查密码是否正确
- 163.com：使用授权码，而非账号密码
- Gmail：不支持常规密码——请在 https://myaccount.google.com/apppasswords 生成应用专用密码

**TLS/SSL 错误：**
- 确保 `IMAP_TLS`/`SMTP_SECURE` 设置与服务器要求匹配
- 如使用自签名证书：将 `IMAP_REJECT_UNAUTHORIZED` 或 `SMTP_REJECT_UNAUTHORIZED` 设为 `false`