Agentic Inbox

一个完全运行在 Cloudflare Workers 上的、集成 AI 代理的自托管电子邮件客户端。

Agentic Inbox 让你能够通过现代化的网页界面发送、接收和管理电子邮件——所有一切都由你自己的 Cloudflare 账户提供支持。入站邮件通过 Cloudflare Email Routing 到达，每个邮箱都通过带有 SQLite 数据库的 Durable Objects 进行隔离，附件则存储在 R2 中。

内置的 AI 驱动电子邮件代理 可以读取你的收件箱、搜索对话并草拟回复——该功能基于 Cloudflare Agents SDK 和 Workers AI 构建。

Agentic Inbox screenshot

阅读博客文章以了解更多关于 Cloudflare Email Service 的信息，以及如何结合 Agents SDK、MCP 和 Wrangler CLI 使用它：Email for Agents。

如何安装

重要提示：点击“Deploy to Cloudflare”按钮只是安装的一部分，你还必须完成 部署后 (After deploying) 的步骤。有关带截图的完整分步指南，请参考此评论： https://github.com/cloudflare/agentic-inbox/issues/4#issuecomment-4269118513

安装步骤

部署到 Cloudflare。部署流程将自动配置 R2、Durable Objects 和 Workers AI。系统会提示你输入 DOMAINS，即你希望接收邮件的域名（例如 yourdomain.com，对应 email@yourdomain.com）。
配置 Cloudflare Access -- 在你的 Worker 的“设置 (Settings) > 域名与路由 (Domains & Routes)”下启用一键式 Cloudflare Access。弹窗中会显示你的 POLICY_AUD 和 TEAM_DOMAIN 值。TEAM_DOMAIN 可以是你的 Access 团队 URL，也可以是完整的 .../cdn-cgi/access/certs URL。你必须将这些值设置为 Worker 的环境变量/机密 (Secrets)。
设置 Email Routing -- 在 Cloudflare 控制面板中，转到“域名 > Email Routing”，并创建一个将邮件转发到此 Worker 的“全捕获 (catch-all)”规则。
启用 Email Service -- Worker 需要 send_email 绑定才能发送出站邮件。请参阅 Email Service 文档。
创建邮箱 -- 访问你部署的应用，为你域名下的任何地址（例如 hello@example.com）创建一个邮箱。

访问故障排除

如果看到 Invalid or expired Access token，通常意味着 POLICY_AUD 或 TEAM_DOMAIN 密钥不正确。
- 解决方法：为该 Worker 关闭再重新开启 Access，以重新调出 Access 弹窗，然后将 Worker 的密钥重置为弹窗中显示的最新的 POLICY_AUD 和 TEAM_DOMAIN 值。
如果看到 Cloudflare Access must be configured in production，这是因为该应用强制要求使用 Cloudflare Access，以防止你的收件箱暴露在公共互联网上。
- 解决方法：使用 Worker 一键式 Cloudflare Access 启用 Access，然后根据弹窗值设置 POLICY_AUD 和 TEAM_DOMAIN 密钥。

功能特性

完整邮件客户端 — 通过 Cloudflare Email Routing 发送和接收邮件，支持富文本编辑器、回复/转发线程、文件夹管理、搜索和附件功能。
邮箱级隔离 — 每个邮箱运行在独立的 Durable Object 中，并带有 SQLite 存储及用于附件的 R2。
内置 AI 代理 — 侧边栏集成了 9 个电子邮件工具，用于读取、搜索、草拟和发送邮件。
新邮件自动草拟 — 代理会自动读取入站邮件并生成回复草稿，发送前始终需要用户明确确认。
可配置且持久化 — 每个邮箱支持自定义系统提示词 (System Prompts)、持久化聊天记录、流式 Markdown 响应以及工具调用可见性。

技术栈

前端： React 19, React Router v7, Tailwind CSS, Zustand, TipTap, @cloudflare/kumo
后端： Hono, Cloudflare Workers, Durable Objects (SQLite), R2, Email Routing
AI 代理： Cloudflare Agents SDK (AIChatAgent), AI SDK v6, Workers AI (@cf/moonshotai/kimi-k2.5), react-markdown + remark-gfm
认证： Cloudflare Access JWT 验证（本地开发环境外必须开启）

入门指南

npm install
npm run dev

配置

在 wrangler.jsonc 中设置你的域名。
创建一个名为 agentic-inbox 的 R2 存储桶：wrangler r2 bucket create agentic-inbox

部署

npm run deploy

前置要求

拥有域名的 Cloudflare 账户
Email Routing