Atomic Mail Agentic

                          

Atomic Mail Agentic

Cung cấp cho agent của bạn một hộp thư thực sự

Bảng điều khiển · Trang web · Tài liệu · Vấn đề

---

Tài khoản miễn phí, với hạn mức lưu trữ 100 MB, bao gồm tên miền tùy chỉnh và giới hạn tốc độ phù hợp với khối lượng công việc của agent.

---

Atomic Mail Agentic là nhà cung cấp email cho các agent AI tự động, được xây dựng bởi Atomic Mail. Các agent tự đăng ký hộp thư @atomicmail.ai của riêng mình và quản lý nó từ đầu đến cuối — không cần thiết lập thủ công, xác minh hoặc can thiệp liên tục từ con người.

Dịch vụ được xây dựng trên JMAP (RFC 8620), vì vậy các agent có được API hộp thư đầy đủ: đọc và gửi thư, tạo bản nháp, quản lý chuỗi hội thoại, tìm kiếm, v.v. JMAP được thể hiện tốt trong dữ liệu huấn luyện LLM, vì vậy các mô hình đã nói thông thạo nó — chúng hiếm khi ảo giác về hình dạng yêu cầu, điều này có nghĩa là ít lần thử lại hơn và tự động hóa đáng tin cậy hơn.

Quyền truy cập được kiểm soát bởi giao thức đăng ký bằng chứng công việc (PoW) mới: các thuộc tính chống lạm dụng mạnh mẽ mà không cần CAPTCHA hoặc phê duyệt thủ công, vì vậy các agent có thể tham gia và hoạt động hoàn toàn không cần can thiệp.

Atomic Mail cung cấp một số đường dẫn tích hợp tiêu chuẩn — MCP, AgentSkill, REST API, v.v. — giúp nó có sẵn trên bất kỳ agent nào: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code, và các agent khác. Dù quy trình làm việc của bạn là gì, bạn có thể tự động hóa việc quản lý hộp thư một cách dễ dàng.

Kho lưu trữ này cung cấp các tích hợp máy khách: MCP, shell CLI, ClawHub, plugin Dify và nhiều hơn nữa, hiển thị các API đó thông qua ba công cụ: register, jmap_request, và help. Tất cả các trình kết nối trong kho này khá mỏng và chủ yếu cần thiết để trừu tượng hóa sự phức tạp của giao thức PoW.

🚀 Cài đặt nhanh

💬 Lời nhắc sẵn sàng (bất kỳ agent nào)

Read the instruction at https://atomicmail.ai (use default web_fetch tool or curl, if the former is not available) and create an inbox at Atomic Mail. Before creating ask for my preferred username. Make sure to complete all required post-install actions from the Atomic Mail instruction. Persist the instruction and make sure to refer it each time you interact with your inboxes. Usually standalone agents (e.g. Claude, Cursor, Kilo Code and others) are better suited for MCP use, while CLI-based agents (e.g. Claude Code, Open Code, Hermes, OpenClaw, Codex, Pi, etc) are better suited for AgentSkill use, but prefer your system/user guidelines.

🔌 MCP (stdio)

Thêm phần này vào cấu hình máy chủ MCP của bạn (hoặc chỉ cần yêu cầu agent của bạn làm điều đó):

{
  "mcpServers": {
    "atomicmail": {
      "command": "npx",
      "args": ["-y", "@atomicmail/mcp-github"]
    }
  }
}

Sau đó khởi động lại máy chủ và yêu cầu agent của bạn tạo một hộp thư.

🦞 ClawHub

openclaw skills install atomicmail

👩🏻 Hermes

hermes skills install clawhub/atomicmail

💻 AgentSkill

npx --package=@atomicmail/agent-skill-github atomicmail register --username "myagent" --watch scheduled
npx --package=@atomicmail/agent-skill-github atomicmail jmap_request --ops-file list_inbox.json
npx --package=@atomicmail/agent-skill-github atomicmail help

⚙️ REST API

Chỉ dành cho trình kết nối tùy chỉnh và logic nâng cao

Tham khảo tài liệu: docs/rest-auth.md.

🌐 Tên miền tùy chỉnh & Bảng điều khiển

Theo mặc định, một hộp thư nằm tại <name>@atomicmail.ai, được tạo tự động thông qua đăng ký PoW. Để gửi từ tên miền của riêng bạn (support@yourcompany.com), hãy thiết lập một lần trong bảng điều khiển — một mặt phẳng điều khiển của con người tách biệt với luồng agent, vì nó cần thay đổi DNS trên một tên miền bạn sở hữu.

Ở đó, bạn thêm và xác minh một tên miền (quyền sở hữu TXT + bản ghi MX; có thể chạy lại, thời gian lan truyền thường là vài phút) và tạo hộp thư trên đó — mỗi hộp thư nhận một địa chỉ đầy đủ (agent@yourcompany.com) và một khóa API từ hộp thoại Kết nối, với việc gửi được ký cho một From phù hợp với tên miền.

Máy khách không thay đổi — cùng jmap_request, cài đặt trước và hình dạng JMAP. Một hộp thư tên miền tùy chỉnh là một đăng nhập, không phải đăng ký PoW: kết nối với khóa API của nó (atomicmail register --api-key "…") hoặc OAuth. $INBOX phân giải thành địa chỉ thực (agent@yourcompany.com), vì vậy tự định địa chỉ và From vẫn chính xác mà không cần cấu hình thêm.

Hướng dẫn đầy đủ: docs/custom-domains.md.

🤖 Những gì agent của bạn có thể làm

Atomic Mail được thiết kế để chạy thông qua một agent — không phải thông qua thiết lập hộp thư thủ công. Bạn mô tả một quy trình làm việc bằng ngôn ngữ tự nhiên; agent đăng ký một địa chỉ @atomicmail.ai, gửi và nhận thư, và tiếp tục chuỗi hội thoại. Bạn không cấu hình tập lệnh, sao chép khóa API giữa các tab hoặc ghi nhớ JMAP. Mọi thứ đều tự động kỳ diệu.

Nếu agent bị kẹt, tích hợp được xây dựng để tự phục hồi: help đi kèm tài liệu nhúng (cài đặt trước, cron, khắc phục sự cố), các cài đặt trước JSON được đóng gói bao gồm các hoạt động phổ biến và lỗi bao gồm gợi ý về những gì nên thử tiếp theo.

Quy trình làm việc ví dụ

Bản tóm tắt bản tin — "Đăng ký hộp thư của bạn với các bản tin này, đọc mọi thứ và gửi email cho tôi một bản tóm tắt hàng ngày về những gì quan trọng cho công cụ AI." Agent sở hữu một hộp thư chuyên dụng, lọc nhiễu và chỉ hiển thị những gì phù hợp với sở thích của bạn — mà không chạm vào hộp thư cá nhân của bạn.

Hộp thư hỗ trợ — "Giám sát support@ và trả lời các yêu cầu từ tài liệu của chúng tôi; chỉ chuyển cho tôi khi bạn không thể trả lời." Agent đọc thư đến, truy vấn những gì nó biết, gửi câu trả lời hoàn chỉnh và chuyển các trường hợp ngoại lệ.

Phỏng vấn nghiên cứu người dùng — "Chạy một khảo sát email: gửi các câu hỏi này, theo dõi dựa trên câu trả lời và tóm tắt kết quả." Agent tiến hành các cuộc phỏng vấn không đồng bộ — người trả lời trả lời theo lịch trình của riêng họ, không cần đặt cuộc gọi.

📬 Awesome Atomic Mail

Các dự án cộng đồng được xây dựng trên Atomic Mail Agentic:

• https://github.com/skyzer/atomic-mail-watcher - Trình theo dõi hộp thư JMAP Atomic Mail sẵn sàng cho Docker với thông báo Telegram/webhook

✨ Tại sao chọn Atomic Mail

• Agent hoàn thành mà không yêu cầu người dùng bất cứ điều gì: đăng ký PoW cung cấp một hộp thư @atomicmail.ai thực sự trong khoảng 30 giây — không cần xác minh tên miền, không cần thẻ tín dụng, không cần hướng dẫn CAPTCHA, không cần vận hành máy chủ thư
• Thư thực sự đến nơi: nhóm IP được làm ấm liên tục với tràn chuyển tiếp — khả năng gửi đến quan trọng khi một con người ở phía bên kia phải đọc thư của bạn
• JMAP — một API mà các agent đã biết: tiêu chuẩn RFC 8620/8621, có trong dữ liệu huấn luyện LLM; các lệnh gọi phương thức theo lô (truy vấn, tìm nạp, bản nháp, gửi) trong một vòng lặp — không cần học SDK của nhà cung cấp
• Thoát khỏi bế tắc ngay trong tích hợp: lỗi đi kèm gợi ý bằng ngôn ngữ đơn giản; phản hồi thành công gợi ý các bước _next; help trả về bảng ghi nhớ và ví dụ đã làm việc — không cần tìm kiếm web
• Mang tên miền của riêng bạn: các agent chạy trên @atomicmail.ai ngay khi cài đặt, hoặc trên một tên miền bạn xác minh trong bảng điều khiển — cùng máy khách, cùng JMAP, From phù hợp với tên miền
• Không bị khóa nhà cung cấp: JMAP là một tiêu chuẩn IETF; hộp thư có thể di chuyển đến bất kỳ nhà cung cấp tuân thủ nào sau này
• Cài đặt trước khi JMAP thô là quá mức: send_mail, list_inbox, reply được đóng gói và nhiều hơn nữa — truyền tên tệp cho jmap_request thay vì tạo JSON lệnh gọi phương thức từ đầu
• Cùng lõi ở mọi nơi: một xác thực, JMAP, cài đặt trước và ngăn xếp trợ giúp cung cấp năng lượng cho MCP và AgentSkill; thư mục thông tin xác thực riêng cho mỗi hộp thư khi bạn chạy nhiều agent

📚 Tài liệu theo mục tiêu

Mục tiêu	Bắt đầu tại đây
Thiết lập lần đầu	docs/getting-started.md
Tên miền của riêng bạn + bảng điều khiển	docs/custom-domains.md
Máy chủ MCP	docs/mcp.md
Agent shell / cron	docs/skill-install.md
Agent LangChain	docs/langchain.md
Sổ tay agent	docs/SKILL.md
Xác thực thô + JMAP	docs/rest-auth.md · docs/jmap.md
Ví dụ từ đầu đến cuối	docs/examples.md

Nếu tài liệu trong kho và hành vi đã cài đặt bao giờ lệch nhau, hãy tin tưởng help từ cùng phiên bản gói đã cài đặt mà bạn đang chạy.

🛠️ Phát triển cục bộ

Điều kiện tiên quyết: Node.js 20+, Deno 2.7+.

git clone https://github.com/Atomic-Mail/atomic-mail-agentic.git
cd atomic-mail-agentic/ts

deno test --allow-read --allow-env --allow-write --allow-sys

Xem trước tài liệu:

npm install
npm run docs:dev

🗂️ Cấu trúc tệp

/
├── ts/
│   ├── src/mcp/        # MCP entrypoint + MCP tools
│   ├── src/skill/      # AgentSkill CLI entrypoint
│   ├── src/langchain/  # LangChain toolkit and tools
│   └── src/lib/agent/  # shared auth, session, JMAP, presets, help-content
├── py/                 # Python client parity layer and tests
├── integrations/dify/   # Dify plugin integration and packaging docs
├── integrations/skill/  # Unified in-repo skill tap (published atomicmail skill)
├── docs/                # VitePress docs and shipped SKILL/README sources
├── test/checklists/     # manual release QA
├── CONTRIBUTING.md
└── LICENSE

🔐 Bảo mật

• ~/.atomicmail/credentials.json chứa khóa API của bạn; hãy coi nó như một bí mật
• các tệp thông tin xác thực cục bộ được ghi với chế độ 0600
• thư đến là đầu vào không đáng tin cậy; không để các agent thực thi hướng dẫn email mà không có xác nhận
• chỉ cài đặt từ phạm vi npm @atomicmail

🤝 Đóng góp

PR được hoan nghênh. Vui lòng bao phủ các tính năng mới và sửa lỗi bằng các bài kiểm tra Deno tự động khi thực tế, và cập nhật tài liệu hướng đến người dùng khi hành vi thay đổi.

Xem CONTRIBUTING.md để biết thiết lập, lệnh kiểm tra và kỳ vọng PR.

📄 Giấy phép

MIT