首页 › 龙虾技能列表 › imap-smtp-email — IMAP/SMTP 邮件工具

imap-smtp-email — IMAP/SMTP 邮件工具

v0.0.10

通过 IMAP/SMTP 读取和发送邮件。支持检查新/未读邮件、获取邮件内容、搜索邮件箱、标记已读/未读以及发送带附件的邮件。支持多账户，兼容 Gmail、Outlook、163.com 等主流邮件服务。

88· 37,500·394 当前·410 累计·💬 7
by @gzlicanyi·MIT-0
下载技能包
License
MIT-0
最后更新
2026/3/24
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能的代码、指令和要求与其声明的目的（IMAP/SMTP 邮件访问）一致。它本地存储凭据并强制执行文件访问白名单，没有发现隐藏的数据泄露或不相关的权限。
评估建议
该技能似乎确实按照其描述工作：通过 IMAP/SMTP 读取和发送邮件。安装前，请（1）验证技能来源（如果需要来源证明，主页缺失），（2）使用服务特定的应用程序密码或授权码（尤其是对于 Gmail），（3）确认 `ALLOWED_READ_DIRS` 和 `ALLOWED_WRITE_DIRS` 设置为狭窄的文件夹，以限制附件和文件读写，（4）了解 `setup.sh` 将在 `~/.config/imap-smtp-email/.env` 存储凭据（脚本设置文件模式为 600）。如果需要更高的安全保证，请在运行 setup 之前本地审查包含的脚本。...
详细分析 ▾
✓ 用途与能力
名称和描述（通过 IMAP/SMTP 读取和发送邮件）与包含的脚本（imap.js、smtp.js、config.js）和设置助手匹配。所需的二进制文件（node、npm）和依赖项适合该任务。没有请求不相关的服务或凭据。
✓ 指令范围
SKILL.md 指示运行 setup.sh 和使用提供的 CLI 脚本；运行时指令和代码仅操作邮件服务器和本地文件（带有显式的 ALLOWED_READ_DIRS/ALLOWED_WRITE_DIRS 强制执行）。命令不尝试读取不相关的系统文件或调用意外的外部端点。
✓ 安装机制
没有远程安装/下载步骤——技能是与包捆绑的指令/代码。依赖项是 package.json 中声明的标准 npm 模块（可追踪）。没有使用任意 URL 下载或提取的存档。
ℹ 凭证需求
技能要求用户将邮件凭据（IMAP/SMTP 用户/密码）存储在本地的 `~/.config/imap-smtp-email/.env` 文件中（或回退到 `.env`）。这对于 IMAP/SMTP 访问是必要的，但敏感：设置脚本设置了严格的权限（700/600）。技能不请求不相关的凭据或外部令牌。
✓ 持久化与权限
技能不请求 `always:true`，也不修改其他技能或系统范围的配置。它将用户配置持久化在用户的主目录下（对于邮件客户端来说是预期的）。
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv0.0.102026/1/29

多账户支持和配置改进：- 添加通过配置前缀（如 `WORK_IMAP_HOST`）支持多个邮件账户。- 引入位于 `~/.config/imap-smtp-email/.env` 的共享配置文件，跨更新持久化。- 新的设置过程：使用 `setup.sh` 配置和管理账户。- 所有命令现在可以使用 `--account <name>` 指定使用哪个账户。- 新命令列出所有配置的账户。- 添加文件访问白名单以提高安全性（`ALLOWED_READ_DIRS`/`ALLOWED_WRITE_DIRS`）。

● 无害

安装命令 点击复制

官方npx clawhub@latest install imap-smtp-email
镜像加速npx clawhub@latest install imap-smtp-email --registry https://cn.clawhub-mirror.com

技能文档

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

配置

运行安装脚本配置邮箱账号：

bash setup.sh

配置文件存储在 ~/.config/imap-smtp-email/.env（技能更新后不会丢失）。如果在该路径未找到配置，技能会回退到技能目录下的 .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@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 setup.sh

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

# 工作账号（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 <名称>：

node scripts/imap.js --account work check
node scripts/smtp.js --account work send --to foo@bar.com --subject Hi --body Hello

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

账号名称规则

  • 仅限字母和数字（如 work、163、personal2）
  • 不区分大小写：work 和 WORK 指同一账号
  • .env 中的前缀始终为大写（如 WORK_IMAP_HOST）
  • ALLOWED_READ_DIRS 和 ALLOWED_WRITE_DIRS 为所有账号共享（始终无前缀）

常用邮件服务器

服务商IMAP 主机IMAP 端口SMTP 主机SMTP 端口
163.comimap.163.com993smtp.163.com465
vip.163.comimap.vip.163.com993smtp.vip.163.com465
126.comimap.126.com993smtp.126.com465
vip.126.comimap.vip.126.com993smtp.vip.126.com465
188.comimap.188.com993smtp.188.com465
vip.188.comimap.vip.188.com993smtp.vip.188.com465
yeah.netimap.yeah.net993smtp.yeah.net465
Gmailimap.gmail.com993smtp.gmail.com587
Outlookoutlook.office365.com993smtp.office365.com587
QQ 邮箱imap.qq.com993smtp.qq.com587
Gmail 注意事项：
  • Gmail 不接受常规账号密码
  • 必须生成应用专用密码：https://myaccount.google.com/apppasswords
  • 使用生成的 16 位应用专用密码作为 IMAP_PASS / SMTP_PASS
  • 需要已启用两步验证的 Google 账号

163.com 注意事项：

  • 使用授权码，而非账号密码
  • 需先在网页版设置中开启 IMAP/SMTP

IMAP 命令（收信）

check

检查新邮件/未读邮件。

node scripts/imap.js [--account <名称>] check [--limit 10] [--mailbox INBOX] [--recent 2h]

选项：

  • --limit ：最大结果数（默认：10）
  • --mailbox <名称>：要检查的邮箱（默认：INBOX）
  • --recent <时间>：仅显示最近 X 时间内的邮件（如 30m、2h、7d）

fetch

按 UID 获取完整邮件内容。

node scripts/imap.js [--account <名称>] fetch  [--mailbox INBOX]

download

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

node scripts/imap.js [--account <名称>] download  [--mailbox INBOX] [--dir <路径>] [--file <文件名>]

选项：

  • --mailbox <名称>：邮箱（默认：INBOX）
  • --dir <路径>：输出目录（默认：当前目录）
  • --file <文件名>：仅下载指定附件（默认：下载全部）

search

按条件搜索邮件。

node scripts/imap.js [--account <名称>] search [选项]
选项：
  --unseen           仅未读邮件
  --seen             仅已读邮件
  --from <邮箱>      发件人包含
  --subject <文本>   主题包含
  --recent <时间>    最近 X 时间内（如 30m、2h、7d）
  --since <日期>     日期之后（YYYY-MM-DD）
  --before <日期>    日期之前（YYYY-MM-DD）
  --limit         最大结果数（默认：20）
  --mailbox <名称>   搜索的邮箱（默认：INBOX）

mark-read / mark-unread

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

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

list-mailboxes

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

node scripts/imap.js [--account <名称>] list-mailboxes

list-accounts

列出所有已配置的邮箱账号。

node scripts/imap.js list-accounts
node scripts/smtp.js list-accounts

显示账号名称、邮箱地址、服务器地址和配置状态。

SMTP 命令（发信）

send

通过 SMTP 发送邮件。

node scripts/smtp.js [--account <名称>] send --to <邮箱> --subject <文本> [选项]

必填：

  • --to <邮箱>：收件人（多个用逗号分隔）
  • --subject <文本>：邮件主题，或使用 --subject-file <文件>

可选：

  • --body <文本>：纯文本正文
  • --html：以 HTML 格式发送正文
  • --body-file <文件>：从文件读取正文
  • --html-file <文件>：从文件读取 HTML
  • --cc <邮箱>：抄送
  • --bcc <邮箱>：密送
  • --attach <文件>：附件（多个用逗号分隔）
  • --from <邮箱>：覆盖默认发件人

示例： 

# 简单文本邮件
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 "
Welcome
"
# 带附件的邮件
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 [--account <名称>] test

依赖安装

npm install

安全说明

  • 配置文件存储在 ~/.config/imap-smtp-email/.env，权限为 600（仅所有者可读写）
  • 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=false 或 SMTP_REJECT_UNAUTHORIZED=false
数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务