📬 Cloudflare Agentic Inbox:3k Stars 的自托管 AI 邮件助手,10 分钟部署不用给第三方交数据
> [项目地址](https://github.com/cloudflare/agentic-inbox) | ⭐ 3,001 Stars | 🛠 TypeScript | 作者 Cloudflare
---
老实说,我试过市面上各种 AI 邮件助手——它们要么要你交出去全部邮件权限,要么只能读不能回,要么装完还要配置一堆第三方服务。Cloudflare 最近开源了个好东西:**Agentic Inbox**,3k Stars,一个完全跑在 Cloudflare Workers 上的自托管邮件客户端 + AI 代理,所有数据在你自己的账户里,一封邮件都不经第三方。
## ⚡ 一句话说清楚
Agentic Inbox = 自托管邮件客户端 + AI 邮件助手,全部跑在 Cloudflare Workers 上。每封邮件到 [Cloudflare Email Routing](https://developers.cloudflare.com/email-routing/) → 进入 Durable Object(SQLite 存储)→ 附件存 R2 → AI Agent 自动读邮件、搜对话、起草回复,全在 Cloudflare 网络里完成。
## 🚀 部署:两个按钮 + 两步配置
别整那些花里胡哨的,核心就这几步:
```bash
# 1. 点 Deploy 按钮(自动创建 R2、Durable Objects、Workers AI)
# https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/agentic-inbox
# 2. 设置 Cloudflare Access(Worker > Settings > Domains & Routes)
# 记下 POLICY_AUD 和 TEAM_DOMAIN 值,设成 Worker secrets
# 3. 打开 Email Routing,创建 catch-all 规则转发到这个 Worker
# 4. 创建 mailbox
# 访问部署好的 app,创建任意邮箱地址(如 hello@你的域名.com)
```
踩过的坑都是泪:`POLICY_AUD` 或 `TEAM_DOMAIN` 设错了会提示 `Invalid or expired Access token`,重新启停一次 Access 拿到最新值再设回去就好。
## 🔧 核心架构
Agentic Inbox 的架构很干净:
- **前端**:React 19 + React Router v7 + Tailwind + TipTap 富文本编辑器
- **存储**:每个邮箱独立一个 Durable Object(SQLite)+ R2 存附件
- **AI Agent**:Cloudflare Agents SDK(`AIChatAgent`)+ Workers AI(`@cf/moonshotai/kimi-k2.5`)
- **认证**:Cloudflare Access JWT(本地开发不需要,部署后强制)
每个邮箱有独立的 system prompt、持久化聊天历史、流式 Markdown 回复、可见的 tool call 执行过程。新邮件进来时 Agent 自动读信 → 起草回复 → 等你确认后才发送。
## 🛠 本地开发
```bash
git clone https://github.com/cloudflare/agentic-inbox
cd agentic-inbox
npm install
npm run dev # 本地开发
npm run deploy # 部署到 Cloudflare
```
## 🔥 最骚的是
Agentic Inbox 有 **9 个邮件工具**:读邮件、搜对话、草稿、发送——全在侧面板里操作。AI Agent 自动读入站邮件生成回复草稿,但**必须你确认后才发送**,不会自作主张。
如果你已经有 Cloudflare 账户,从部署到用上不到 10 分钟。对比那些要你上传邮箱密码的 AI 邮件助手,这玩意儿才是开发者该用的方案。
## 要点总结
- **完全自托管**:所有数据在你自己 Cloudflare 账户里,不经过第三方
- **一个按钮部署**:自动创建 R2 + Durable Objects + Workers AI
- **AI 自动回复**:9 个工具,入站邮件自动起草,确认后才发送
- **每个邮箱独立隔离**:各自独立的 Durable Object + SQLite + 配置
- **零额外成本**:利用 Cloudflare 免费额度就能跑起来,不需要搭服务器
> 标签:#Cloudflare #AI #Email #SelfHosted #Workers #OpenSource