An API-first email platform that provides AI agents with programmatic inboxes, real-time webhooks, and high-volume sending capabilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agentmail
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install agentmail using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AgentMail?
AgentMail is a specialized email infrastructure designed from the ground up for AI agents. Unlike consumer email services like Gmail or Outlook, AgentMail focuses on programmatic access, providing Openclaw Skills with the ability to create, manage, and scale email-based identities. It offers a seamless experience for developers who need to integrate email functionality into their agentic workflows without dealing with complex OAuth flows or restrictive rate limits.
By using AgentMail, your agents gain a professional communication channel capable of handling rich text, HTML content, and file attachments. This platform is a core component for Openclaw Skills that require reliable inbound and outbound communication, enabling agents to act as first-class citizens in the global email ecosystem while maintaining a developer-first approach to infrastructure.
AgentMail Use Cases
- Replacing consumer email providers with programmatic infrastructure for Openclaw Skills.
- Developing automated customer support systems that respond to inquiries via email.
- Creating unique email identities for AI agents to sign up for and interact with external web services.
- High-volume notification systems that send updates or reports to human users.
- Real-time document processing workflows where files are sent to an agent for analysis.
How AgentMail Works
- Create an account and generate a secure API key through the AgentMail dashboard.
- Use the Python SDK to programmatically generate an inbox with a custom username.
- Send messages with attachments and rich HTML formatting directly from your agent's code.
- Configure real-time webhooks to push incoming emails to your backend for immediate processing.
- Apply security transforms via Clawdbot to allowlist trusted senders and protect against prompt injection.
AgentMail Setup
To integrate AgentMail into your Openclaw Skills, perform the following installation steps:
- Register at console.agentmail.to and obtain your API key.
- Install the required dependencies:
pip install agentmail python-dotenv
- Set your environment variable in your project configuration:
export AGENTMAIL_API_KEY='your_api_key_here'
- Initialize the client in your script to begin managing inboxes and sending emails.
AgentMail Data Schema & Taxonomy
AgentMail organizes its data to be highly accessible for Openclaw Skills, focusing on programmatic entities:
| Component | Function | Attributes |
|---|---|---|
| Inbox | Represents the agent's email account. | inbox_id, username, client_id |
| Message | The payload of an email transmission. | to, subject, text, html, attachments |
| Webhook | Configuration for real-time events. | url, client_id |
| Attachment | Files associated with a message. | filename, content (base64) |
All data is handled via an API-first approach, ensuring that messages are easily parsed into structured formats for LLM consumption.
AgentMail Advanced Features
- Custom domain support to enable branded email addresses for your Openclaw Skills.
- Real-time webhook allowlisting to secure agents against malicious prompt injection from untrusted senders.
- AI-native features including semantic search and automatic labeling for incoming message management.
- Idempotency support for inbox creation to prevent duplicate identities across distributed agent sessions.
- Isolated session management for reviewing untrusted emails before they are delivered to the main agent chat.
SKILL.md
Loading
Related Openclaw Skills
camoufox-tools
A streamlined CLI toolkit for camoufox and agent-browser designed to simplify anti-detection web automation and high-performance data scraping.
Camoufox Deploy
A one-click deployment tool that patches agent-browser to support Camoufox for advanced web anti-detection and stealth automation.
Agent Browser with Camoufox
A specialized deployment kit that patches agent-browser to support the Camoufox anti-detection browser for stealthy web automation.
Telegram Marketing Audit Command Handler
A Telegram command handler that automates full marketing audits for websites and Instagram profiles directly within your chat interface.
AUTO-BUILDING AI Information Collector
An AI-driven automated information collection and management system for building custom content platforms.
Google Tasks Skill
A lightweight bash-based interface for managing Google Tasks lists, items, and due dates via the REST API.
Featured*
