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

Name: imap-smtp-email — IMAP/SMTP 邮件工具
Rating: 88

v0.0.10

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

88· 3.8万·394 当前·410 累计

by @gzlicanyi·MIT-0

AI模型访问网络工具开发工具

下载技能包

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.longxiaskill.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.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

检查新邮件/未读邮件。

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 ↗ · 中文优化：龙虾技能库