imap-smtp-email-zh

Files (8)

• SKILL.md
• _meta.json
• package-lock.json
• package.json
• config.js · scripts/
• imap.js · scripts/
• smtp.js · scripts/
• setup.sh

SKILL.md (first lines)

# IMAP/SMTP 邮件工具

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

## 配置

运行配置脚本设置邮箱账号：

```bash
bash setup.sh
```

配置文件存储在 `~/.config/imap-smtp-email/.env`（技能更新后不会被覆盖）。如果该路径未找到配置，将回退到技能目录下的 `.env` 文件（向后兼容）。

### 配置文件格式

```bash
# 默认账号（无前缀）
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_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your@email.com
SMTP_PASS=your_password
SMTP_FROM=your@email.com
SMTP_REJECT_UNAUTHORIZED=true

# 文件访问白名单（安全限制）
ALLOWED_READ_DIRS=~/Downloads,~/Documents
ALLOWED_WRITE_DIRS=~/Downloads
```

## 多账号

可以在同一配置文件中添加多个邮箱账号。每个账号使用名称前缀（大写）来区分所有变量。

### 添加账号

运行配置脚本并选择"添加新账号"：

```bash
bash setup.sh
```

或手动在 `~/.config/imap-smtp-email/.env` 中添加带前缀的变量：

```bash
# 工作账号（WORK_ 前缀）
WORK_IMAP_HOST=imap.company.com
WORK_IMAP_PORT=993
WORK_IMAP_USER=me@company.com
WORK_IMAP_PASS=password
WORK_IMAP_TLS=true
WORK_IMAP_REJECT_UNAUTHORIZED=true
WORK_IMAP_MAILBOX=INBOX
WORK_SMTP_HOST=smtp.company.com
WORK_SMTP_PORT=587
WORK_SMTP_SECURE=false
WORK_SMTP_USER=me@company.com
WORK_SMTP_PASS=password
WORK_SMTP_FROM=me@company.com
WORK_SMTP_REJECT_UNAUTHORIZED=true
```

### 使用指定账号

在命令前添加 `--account <名称>`：

```bash
node scripts/imap.js --account work check
node scripts/smtp.js --account work send --to foo@bar.com --subject 你好 --body 你好世界
```

不指定 `--account` 时，使用默认（无前缀）账号。

### 账号命名规则

- 仅允许字母和数字（如 `work`、`163`、`personal2`）
- 大小写不敏感：`work` 和 `WORK` 指向同一账号
- `.env` 中的前缀始终为大写（如 `WORK_IMAP_HOST`）
- `ALLOWED_READ_DIRS` 和 `ALLOWED_WRITE_DIRS` 为所有账号共享（始终无前缀）

## 常用邮箱服务器

| 服务商 | 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 **不接受**普通账号密码
- 必须生成**应用专用密码**：https://myaccount.google.com/apppasswords
- 将生成的 16 位应用专用密码作为 `IMAP_PASS` / `SMTP_PASS`
- 需要开启 Google 账号两步验证

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

## IMAP 命令（收邮件）

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

From L-LesterYu/OpenClaw-hot-skills-zh, MIT.

More from L-LesterYu/OpenClaw-hot-skills-zh