claw-mail

支持IMAP/SMTP协议的多账户邮件管理技能,可获取、阅读、搜索、撰写、发送、回复、转发和整理多账户邮件。

安装

概览

claw-mail 是一个专为开发者设计的开源邮件管理技能(Skill),支持通过 IMAP/SMTP 协议高效管理多个邮箱账户。它提供了一套完整的命令行工具链,涵盖从获取、阅读、搜索到撰写、发送、回复、转发和归档邮件的全流程操作。其核心优势在于多账户统一管理能力,允许用户为每个账户配置独立的 IMAP/SMTP 凭据、处理规则与存档策略,并自动指定一个默认账户以简化日常使用。系统内置安全机制,强制启用 TLS 1.2+ 加密连接,仅允许现代高强度密码套件,并支持 OAuth2、1Password CLI、macOS Keychain 等多种安全凭证存储方式,确保敏感信息不被明文暴露。所有脚本均可在 `scripts/` 目录下独立运行,且接受 `–account` 参数灵活切换目标账户,极大提升了自动化场景下的可维护性。

核心功能特点

  1. 支持多邮箱账户统一接入与管理,具备灵活的默认账户与 SMTP 故障自动回退机制
  2. 提供 15 个核心脚本覆盖邮件全生命周期:获取、阅读、搜索、撰写、发送、回复、转发、草稿管理、规则处理等
  3. 内置 IMAP Outbox 机制保障邮件可靠投递,失败消息自动滞留重试,避免丢失
  4. 强安全性设计:强制 TLS 1.2+ 加密、禁用弱密码套件、完整证书验证,支持 OAuth2 及多种安全凭证后端
  5. 支持基于规则的自动化邮件处理与归档,可按日/周/月/年生成结构化存档文件夹(如 Archive-202603)
  6. 集成邮件合并(Mail Merge)、日历邀请、S/MIME 签名加密等企业级功能

适用场景

claw-mail 特别适合需要高度自动化和集中管控邮件流的开发者和运维人员。对于同时使用工作邮箱和个人邮箱的用户,它能在一个终端会话中无缝切换不同账户,执行批量操作如定时拉取新邮件、按关键词过滤重要信息或自动分类归档,显著减少手动干预。在 DevOps 场景中,该工具可用于构建 CI/CD 流水线中的通知系统——例如项目构建完成后自动发送 HTML 格式的状态报告;或通过邮件合并向客户群批量发送个性化账单或营销内容。企业 IT 管理员也可利用其规则引擎实现自动标记紧急邮件、将特定发件人的消息移至指定文件夹,甚至结合 webhook 触发外部服务响应。此外,支持 IMAP IDLE 监听模式,使其成为构建实时邮件推送服务的理想基础组件,适用于聊天机器人、告警系统等对时效性要求高的应用。