| 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_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@gmail.com
SMTP_PASS=your_password
SMTP_FROM=your@gmail.com
SMTP_REJECT_UNAUTHORIZED=true
常用邮件服务器
| 服务商 | 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 注意事项：
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"
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
安全注意事项
常见问题排查
连接超时：
- 确认服务器正在运行且可访问
- 检查主机名和端口配置是否正确
认证失败：
TLS/SSL 错误：
- 确保
IMAP_TLS/SMTP_SECURE 设置与服务器要求匹配
- 如使用自签名证书：将
IMAP_REJECT_UNAUTHORIZED 或 SMTP_REJECT_UNAUTHORIZED 设为 false
