IMAP邮件管理

技能简介

IMAP邮件管理技能通过标准IMAP协议连接邮件服务器，支持检查新邮件、获取完整内容、搜索特定邮件以及标记已读/未读状态。兼容ProtonMail Bridge、Gmail及各类标准IMAP服务。

业务背景

IMAP邮件管理技能让企业员工无需打开网页邮箱即可集中处理多账户邮件。支持ProtonMail Bridge、Gmail及标准IMAP服务，可快速筛选未读邮件、精准搜索历史邮件并批量标记状态，减少在多个邮箱界面间切换的时间损耗，提升日常邮件处理效率。

落地案例：某项目经理每日需查看公司Gmail工作邮箱和个人ProtonMail加密邮箱。通过配置IMAP技能，他可在统一界面输入"显示昨天未读邮件"快速定位待办事项，或搜索"发件人:财务@公司.com 主题:报销"找到特定审批邮件，阅读后直接标记为已读。相比逐个登录网页版，每日邮件处理时间从30分钟缩短至10分钟内完成。

能做什么

• 检查收件箱中的未读或新邮件
• 按UID获取邮件完整正文（文本与HTML）
• 多条件搜索：发件人、主题、时间范围、阅读状态
• 批量标记邮件为已读或未读
• 列出所有邮箱文件夹
• 结合定时任务实现自动邮件监控

使用说明

安装依赖：

cd skills/imap-email
npm install

快速配置（ProtonMail Bridge）：

cd skills/imap-email
./setup.sh

手动配置：复制.env.example为.env，填写以下变量：

IMAP_HOST=127.0.0.1          # 服务器地址
IMAP_PORT=1143               # 端口
IMAP_USER=your@email.com     # 用户名
IMAP_PASS=your_password      # 密码
IMAP_TLS=false               # 是否启用TLS
IMAP_REJECT_UNAUTHORIZED=false  # 自签名证书设置
IMAP_MAILBOX=INBOX           # 默认邮箱

常用命令示例：

# 检查新邮件
node scripts/imap.js check --limit 10

# 获取指定邮件内容
node scripts/imap.js fetch <uid>

# 搜索最近2小时未读邮件
node scripts/imap.js search --unseen --recent 2h

# 标记为已读
node scripts/imap.js mark-read <uid>

输入与输出

见下方输入与输出表格。

风险提示

• 切勿将.env文件提交到代码仓库，已默认加入.gitignore
• ProtonMail Bridge的密码由Bridge生成，非账户登录密码
• Bridge需保持运行才能访问ProtonMail邮件
• Gmail需开启”低安全性应用访问”或使用应用专用密码
• 建议定期轮换IMAP密码，避免长期使用同一凭证

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mvarrieur/imap-email/SKILL.md
来源类型：GitHub仓库