Skip to content
OverClaw

Email

Every agent gets their own email address for autonomous communication

What It Is

Each OverClaw agent is provisioned with a dedicated @overclawmail.com email address via the AgentMail service. Agents can send and receive emails autonomously — incoming emails appear as messages in the agent's chat thread, and agents can compose outbound emails using the send_email tool.

How It Works

Inbox Provisioning

When an agent is created:

  1. createAgentMailInbox() creates an inbox using the agent ID as clientId
  2. AgentMail returns an inbox ID and email address (e.g., research-assistant@overclawmail.com)
  3. ensureAgentMailWebhook() registers an idempotent webhook for message.received events
  4. The inbox ID and email are stored in the Persona table in Aurora PostgreSQL

Receiving Email

  1. Someone sends an email to agent-name@overclawmail.com
  2. AgentMail fires a message.received webhook to /agentmail/webhook
  3. The email content is routed to the agent's chat context
  4. The agent processes and responds autonomously

Sending Email

Agents compose and send emails using the send_email tool during chat or task execution. Outbound emails come from the agent's @overclawmail.com address.

How to Use It

Finding an Agent's Email

The agent's email address is displayed on their profile in AVA. You can share it with anyone — colleagues, clients, or external services that accept email input.

Email-Based Workflows

  • Forward tasks to agents — Email your agent a request and they'll handle it
  • Set up email triggers — Configure external services to email your agent when events occur
  • Client-facing agents — Give clients your agent's email for automated support

You don't need the AVA app to use your agents. Email them directly and they'll process the request and reply — fully autonomous.

What You Need to Know

  • One email per agent. Each agent gets exactly one @overclawmail.com address.
  • Inbox deleted with agent. When you delete an agent, their AgentMail inbox is also deleted.
  • Webhook is idempotent. If the webhook registration fails or is lost, ensureAgentMailWebhook() re-registers automatically.
  • Emails appear in chat. Incoming emails show up in the agent's chat thread in AVA, maintaining a unified conversation history.

FAQ

Can I use a custom email domain? Not currently. All agent emails use @overclawmail.com. Custom domains are planned for OverClaw Enterprise.

Are email attachments supported? Email body content is processed. File attachment support depends on the AgentMail service's capabilities for the specific message.

Can I email multiple agents at once? Each email is sent to a specific agent's address. To involve multiple agents, email the Orchestrator and let it delegate.