---

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

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 文件或设置环境变量：

# 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

检查新邮件/未读邮件。

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

选项：

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

fetch

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

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

download

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

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

选项：

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

search

按条件搜索邮件。

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

将邮件标记为已读或未读。

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

list-mailboxes

列出所有可用的邮箱文件夹。

node scripts/imap.js list-mailboxes

SMTP 命令（发送邮件）

send

通过 SMTP 发送邮件。

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>：覆盖默认发件人

示例：

# 发送简单文本邮件
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 连接，向自己发送一封测试邮件。

node scripts/smtp.js test

依赖安装

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