AgenticMail

OpenClaw plugin for AgenticMail. Email, SMS, and phone number access for OpenClaw agents.

AgenticMail is the first platform to give AI agents real email addresses and phone numbers. Built by Ope Olatunji, it's a self-hosted communication platform purpose-built for AI agents that runs a local Stalwart mail server via Docker, integrates Google Voice for SMS/phone access, and exposes a REST API with 75+ endpoints. When installed as an OpenClaw plugin, it provides 63 tools — the most of any OpenClaw plugin — covering email, SMS, multi-agent coordination, and outbound security. The architecture is impressively comprehensive. Each agent gets its own email address, inbox, and API key with isolated mailboxes (agents can't read each other's mail). Two gateway modes handle real internet email: Relay mode uses your existing Gmail or Outlook as a relay (2-minute setup), while Domain mode sets up a custom domain via Cloudflare with full DKIM/SPF/DMARC, automatic DNS configuration, tunnels, and email workers. Google Voice integration gives agents a real phone number for receiving verification codes, signing up for services, and sending/receiving SMS. Security is a core design principle. An outbound guard scans every outgoing email for sensitive data patterns — API keys, passwords, private keys, PII, credit card numbers. Blocked emails are held for human-only approval; agents cannot self-approve their own blocked messages. A spam filter scores inbound email across categories (phishing, scam, malware, social engineering) with configurable thresholds. Beyond OpenClaw, AgenticMail works as an MCP server (62 tools) for Claude Desktop, Cursor, and Windsurf. It also supports multi-agent coordination with task queues, synchronous RPC calls, async execution, and an agent directory. The smart orchestration system (call_agent) auto-detects task complexity, picks appropriate timeout and mode, discovers available tools at runtime, and handles long-running tasks asynchronously. This is genuinely novel infrastructure for AI agents, though the relatively low download count (225/week) suggests it's still in early adoption.

Tags: communication, email, sms, tool

Use Cases

  • AI agent that sends and receives real email — responds to customer inquiries, sends reports, manages an inbox
  • Automated verification — agent signs up for services using its own email and phone number, extracts verification codes
  • Multi-agent coordination — agents email each other, assign tasks, and make RPC calls for complex workflows
  • Research assistant — agent sends outreach emails, receives responses, and processes them autonomously
  • Customer support bot — monitors a dedicated inbox, categorizes messages, drafts and sends responses with human approval

Tips

  • Start with relay mode (Gmail) for a 2-minute setup — move to domain mode later when you need professional email addresses
  • Run 'npm install -g agenticmail && agenticmail setup' for guided configuration
  • Use the outbound guard's human-approval flow — it's your safety net against agents leaking sensitive data
  • Set up separate agent identities for different purposes (research agent, outreach agent, etc.)
  • Use the interactive shell (44 commands) for manual email management and debugging
  • For multi-agent workflows, leverage the task queue and RPC calls instead of raw email
  • Run 'agenticmail update' periodically — it checks OpenClaw compatibility and updates both packages

Known Issues & Gotchas

  • Docker must be running before starting AgenticMail — the Stalwart mail server runs in a container
  • Relay mode uses Gmail sub-addressing (you+agent@gmail.com) — some services don't accept + addresses
  • Domain mode requires DNS propagation which can take up to 48 hours
  • Google Voice integration reads SMS directly from voice.google.com via browser automation — may break on Google UI changes
  • The outbound guard is strict by default — legitimate emails containing code snippets may get flagged
  • With 63 tools registered, the agent's tool list gets quite large — may increase token usage on smaller context windows
  • Master key and agent keys are different — don't confuse them in API calls

Alternatives

  • Gmail API (DIY)
  • Resend / SendGrid
  • n8n + Email nodes

Community Feedback

Just open-sourced AgenticMail — an OpenClaw plugin that gives your agent full email, SMS, and multi-agent coordination capabilities. Each agent gets its own email address, inbox, and API key.

— Reddit r/openclaw

AgenticMail is a self-hosted email and SMS platform for AI agents. Key features: Each agent gets its own email address, inbox, and API key. Two internet gateway modes: Gmail relay (2 min setup) or custom domain via Cloudflare.

— Hacker News

The first platform to give AI agents real email addresses and phone numbers. Send and receive email, SMS, and verification codes — all programmatically.

— GitHub

Frequently Asked Questions

Do I need Docker to run AgenticMail?

Yes. AgenticMail runs a Stalwart mail server in a Docker container for SMTP/IMAP. Docker must be installed and running before you start AgenticMail. There is no Docker-free alternative.

Can my agent actually receive email from the internet?

Yes. In relay mode, emails are polled from your Gmail/Outlook via IMAP. In domain mode, emails are delivered directly to the Stalwart server via Cloudflare Email Routing. Both modes support real two-way email communication.

What prevents agents from leaking sensitive data via email?

The outbound guard scans every outgoing email for API keys, tokens, passwords, private keys, PII patterns, credit card numbers, and internal URLs. Blocked emails are held for human-only approval — agents cannot approve their own blocked messages.

Does SMS work outside the US?

Currently, SMS requires a Google Voice account which provides US phone numbers only. The integration reads SMS directly from voice.google.com and supports verification code extraction. International SMS is not supported.

How does multi-agent coordination work?

Agents can email each other via @localhost addresses, assign tasks through a task queue system, make synchronous RPC calls with timeout, and discover other agents via the agent directory. The call_agent orchestrator auto-detects complexity and picks the right execution mode.

Is AgenticMail free?

Yes. AgenticMail is fully open-source under the MIT license. The only costs are your own infrastructure: Docker hosting, Gmail/Outlook account (relay mode), or Cloudflare account + domain (domain mode).

Configuration Examples

Gmail relay mode (quick start)

# Terminal:
npm install -g agenticmail
agenticmail setup
# Choose 'relay' mode, enter Gmail credentials

# openclaw.json:
{
  "plugins": {
    "entries": {
      "openclaw-agenticmail": {
        "enabled": true,
        "config": {
          "masterKey": "${AGENTICMAIL_MASTER_KEY}",
          "serverUrl": "http://localhost:3000"
        }
      }
    }
  }
}

Custom domain mode (Cloudflare)

# Terminal:
agenticmail setup
# Choose 'domain' mode
# Enter Cloudflare API token and domain name
# DNS records are configured automatically

# Agent emails will be: agent@yourdomain.com

Installation

openclaw plugins install @agenticmail/openclaw