agenticmail
首个让AI Agent拥有真实邮箱地址和电话号码的开源通信基础设施，支持MCP/Claude Code/Codex多框架集成
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
首个让AI Agent拥有真实邮箱地址和电话号码的开源通信基础设施，支持MCP/Claude Code/Codex多框架集成
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
图1：AgenticMail 项目 Logo
想象这样一个场景：你给团队里最得力的 AI Agent 下达了任务——"联系王总，确认合同条款"。Agent 立刻开始了工作：它查资料、分析合同、拟定回复，一切都顺利完成。然而当它准备发出邮件时，问题来了——它没有邮箱地址。
这是当前所有 AI Agent 框架共同面临的尴尬处境：Agent 可以执行任务，可以调用工具，可以推理决策，但它们没有持久化的身份。你无法让 Agent 回复一封邮件，因为没有人给 Agent 分配过邮箱；你无法让两个 Agent 互相协作，因为它们之间没有通信渠道；你无法让用户给 Agent 发消息，因为根本没有收件箱。
AgenticMail 正是为了解决这个根本性问题而生。它是第一个让 AI Agent 拥有真实邮箱地址、电话号码和短信能力的开源平台。通过将传统的邮件基础设施（SMTP/IMAP）与现代 Agent 框架（MCP、Claude Code）深度整合，AgenticMail 把"邮箱"这个人类互联网时代的标配，移植到了 Agent 时代。
传统互联网中，邮箱是每个人在数字世界的身份锚点——它稳定、可寻址、能接收回复。而当前的 AI Agent 框架（如 LangChain、AutoGPT、CrewAI）虽然提供了工具调用能力，却几乎不考虑持久化身份和异步通信这两个核心需求。
这导致了一个有趣的现象：你可以让 Agent 发送一封邮件，但它其实是在"借用"人类的邮箱。Agent 发送的邮件显示的是你的邮箱地址，回复也回到你的收件箱，Agent 本身并没有真正参与通信循环。
AgenticMail 的核心设计理念非常清晰：为每个 Agent 分配独立的邮箱地址和电话号码，让 Agent 拥有自己真实的通信身份。
在这个框架下，不再是"你帮 Agent 发邮件"，而是"Agent 用自己的邮箱发邮件"。用户可以直接给 Agent 发邮件，Agent 自动接收、阅读、分析并回复。整个通信链路完全自主运行，人类的角色从"中间人"变成了"旁观者"。
项目支持三种通信模式：
AgenticMail 采用 TypeScript Monorepo 架构，通过 npm workspaces 组织代码，包含以下核心模块：
| Workspace | 职责 | 关键技术 |
|---|---|---|
@agenticmail/core | 邮件收发核心库 | imapflow, nodemailer, mailparser |
@agenticmail/mcp | MCP Server 实现 | Model Context Protocol, 63个工具 |
@agenticmail/api | REST API 服务 | Node.js Web Framework |
@agenticmail/cli | 命令行工具 | Commander.js |
@agenticmail/claudecode | Claude Code 插件 | Claude Code Plugin SDK |
@agenticmail/codex | OpenAI Codex 集成 | OpenAI API |
@agenticmail/openclaw | OpenClaw 插件 | OpenClaw Plugin SDK |
core 包是整个系统的通信中枢。它封装了 IMAP 和 SMTP 协议，提供高层次的邮件操作接口。
IMAP 接收：通过 imapflow 库建立持久化的 IMAP 连接，支持实时监听新邮件。当有新邮件到达时，Agent 可以立即感知并处理，无需轮询。mailparser 库负责解析 MIME 邮件格式，提取正文、附件、HTML 内容等。
SMTP 发送：nodemailer 处理邮件发送逻辑，支持 DKIM/SPF/DMARC 配置，确保外发邮件的送达率。Agent 发送的每一封邮件都来自它自己的域名，具备完整的邮件信誉。
WebSocket 支持：core 包还集成了 WebSocket（ws 库），支持实时通信场景。例如语音通话时，46elks 平台通过 WebSocket 推送通话数据。
MCP（Model Context Protocol）是 Anthropic 主导的 Agent 与外部工具之间的通信标准。AgenticMail 的 MCP Server 实现了 63 个工具，涵盖：
这些工具通过 MCP 协议暴露，Claude Desktop、Cursor、VS Code 等支持 MCP 的客户端可以直接连接，让 Agent 在对话中直接操控邮件。
AgenticMail 不仅仅是一个 MCP Server，它同时支持多种 Agent 框架：
这种多框架支持策略，确保了 AgenticMail 不依赖于某一个特定的 Agent 运行时，而是作为通信基础设施服务整个 Agent 生态。
AgenticMail 提供两种安装路径：
方式一：一键安装脚本（推荐尝鲜）
curl -fsSL https://raw.githubusercontent.com/agenticmail/agenticmail/main/install.sh | bash
脚本会自动执行 npm install -g agenticmail 并运行引导配置。
方式二：手动安装
npm install -g agenticmail
agenticmail setup
AgenticMail 的独特之处在于它不自己实现邮件服务器，而是与专业的邮件服务器软件 Stalwart 深度集成。Stalwart 是一个用 Rust 编写的开源邮件服务器，支持 JMAP、SMTP、IMAP 协议，配置简单，安全性高。
docker-compose.yml 中固定使用 stalwartlabs/stalwart:v0.15.5 镜像（项目维护者特意锁定版本，因为 v0.16+ 改了配置格式，导致 agenticmail setup 脚本失效）。
启动后，Stalwart 监听以下端口：
8080：Web 管理界面 + JMAP API587：SMTP 提交端口143：IMAP 端口25：SMTP 标准端口运行 agenticmail setup 后，系统会引导用户完成：
整个过程需要一定的技术理解，特别是域名 DNS 配置部分，对于非技术用户有一定门槛。
项目最新版本引入了 Email Wake Events 功能，解决了传统轮询方案的效率问题。启用后，当 Agent 的邮箱收到新邮件时，系统自动触发 Agent 唤醒流程，无需持续轮询 IMAP 服务器。
用户为 AI 助手注册一个专属邮箱（如 assistant@yourdomain.com），将所有重要邮件转发给 Agent 处理。Agent 自动分类优先级、总结邮件内容、生成回复草稿，用户审核后发送。
在企业场景中，不同 Agent 负责不同职能——Researcher Agent 收集行业资讯，Writer Agent 撰写报告，Coordinator Agent 统筹协调。它们之间通过 AgenticMail 互相发送任务邮件，实现真正的异步协作。
调用方式非常简洁：
call_agent(target="researcher", task="分析竞品动态，整理成报告")
// Researcher Agent 接收任务 → 执行 → 返回结果
// Coordinator Agent 收到报告 → 继续后续工作
将 AgenticMail 接入企业客服邮箱，Agent 自动接收客户邮件、分析意图、生成回复，并根据内容复杂度决定：
相比普通 API 服务，邮件系统天然具有更高的复杂度。垃圾邮件过滤、邮件送达率（SPF/DKIM/DMARC 三剑客配置）、邮件服务商限制等问题，是任何邮件基础设施项目都必须面对的挑战。
语音通话功能依赖 46elks 平台，SMS 功能依赖 Google Voice。这些第三方服务的可用性和成本直接影响 AgenticMail 的完整功能体验。
docker-compose.yml 中硬编码了 Stalwart v0.15.5 的版本号，这是一个技术债务信号。如果 Stalwart 未来发布重要安全更新，项目需要及时迁移配置格式（从 TOML 迁移到 JSON）。
项目 README 和文档较为详细，但部分高级功能（如多 Agent 协作、数据库表创建 API）的使用说明仍有提升空间。
AgenticMail 在 GitHub 上已获得 174 颗星，npm 平台月下载量超过 2700 次。项目的 21 个 GitHub Topics 覆盖了 agent、ai-agent、mcp、model-context-protocol 等热门标签，体现了其与当前 AI Agent 生态的深度契合。
从行业视角看，AgenticMail 代表了一个重要趋势：AI Agent 从"任务执行者"向"数字公民"演进。当 Agent 拥有了真实的通信身份，它们就不再是只能被动响应指令的工具，而是可以在数字世界中主动交互、协作、成长的主体。
随着 MCP 协议的推广和更多 Agent 框架的成熟，AgenticMail 这类通信基础设施的价值将持续放大。它不仅仅是给 Agent 一个邮箱，更是为 Agent 时代的数字协作奠定基础。
# 一键安装
curl -fsSL https://raw.githubusercontent.com/agenticmail/agenticmail/main/install.sh | bash
# 配置
agenticmail setup
# 启动（依赖 Docker）
npm run docker:up
# CLI 使用
agenticmail start
agenticmail status
最低要求：Node.js >= 18、Docker & Docker Compose、1GB 内存、2GB 磁盘空间。
官网：https://agenticmail.io | MIT 许可证