GitHub - cloudflare/agentic-inbox: A self-hosted email client with an AI agent, running entirely on Cloudflare Workers
Agentic Inbox 是一个完全运行在 Cloudflare Workers 上的自托管邮箱客户端，自带 AI 代理，支持发送、接收和管理邮件。每个邮箱通过 Durable Object 和 SQLite 隔离，附件存储于 R2，AI 代理基于 Cloudflare Agents SDK 和 Workers AI 构建，可自动阅读收件箱、搜索会话并起草回复。
社区作者 · zZz
它解决什么问题
Agentic Inbox 是一个自托管邮箱客户端，完全基于 Cloudflare Workers 运行，提供现代 Web 界面用于发送、接收和管理邮件。入站邮件通过 Cloudflare Email Routing 接入，每个邮箱在独立的 Durable Object 中隔离并使用 SQLite 数据库，附件存储在 R2 中。内置的 AI 邮件代理可读取收件箱、搜索对话、起草和发送回复，基于 Cloudflare Agents SDK 和 Workers AI 构建。
项目采用 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。源代码以 Apache 2.0 许可证发布。适用对象：希望自部署邮箱服务并利用 AI 自动化处理邮件的开发者和团队，尤其是 Cloudflare 生态用户。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
设置步骤（重要：点击“Deploy to Cloudflare”按钮只是安装的一部分，还必须完成部署后的步骤。完整截图逐步指南参见 issue 评论：#4 (comment)）：
- 点击 Deploy to 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 team URL，或完整的 .../cdn-cgi/access/certs URL。必须将这些值设置为 Worker 的 secrets。
- 设置 Email Routing —— 在 Cloudflare 仪表盘中，进入你的域名 > Email Routing，创建 catch-all 规则并转发到该 Worker。
- 启用 Email Service —— Worker 需要 send_email 绑定才能发送外发邮件。参见 Email Service 文档。
- 创建邮箱 —— 访问部署的应用，为你域名下的任意地址创建邮箱（例如 hello@example.com）。
本地开发：
npm installnpm run dev配置：
- 在 wrangler.jsonc 中设置你的域名
- 创建 R2 bucket：wrangler r2 bucket create agentic-inbox
部署：
npm run deploy前提条件：
- 带域名的 Cloudflare 账户
- 启用 Email Routing（用于收信）
- 启用 Email Service（用于发信）
- 启用 Workers AI（用于 agent）
- 为部署/共享环境配置 Cloudflare Access（生产环境必需）
故障排除：
- 如果看到“Invalid or expired Access token”，通常表示 POLICY_AUD 或 TEAM_DOMAIN secrets 不正确。解决方法：关闭再重新打开 Worker 的 Access，以重新获取 Access 弹窗，然后将 Worker secrets 重置为弹窗中显示的最新 POLICY_AUD 和 TEAM_DOMAIN 值。
- 如果看到“Cloudflare Access must be configured in production”，这是应用有意强制要求 Cloudflare Access，以免收件箱暴露给互联网上的任何人。解决方法：使用 Workers 的一键 Cloudflare Access 启用 Access，然后从弹窗值设置 POLICY_AUD 和 TEAM_DOMAIN Worker secrets。
注意：任何通过共享 Cloudflare Access 策略的用户都可以访问该应用中的所有邮箱（包括 /mcp 的 MCP 服务器）。没有针对每个邮箱的授权；Cloudflare Access 策略是唯一的信任边界。
