AgentMail is an API-first email infrastructure that allows AI agents to create programmatic inboxes, send high-volume messages, and process incoming mail via real-time webhooks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agentemail
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 agentemail 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 platform designed from the ground up for the needs of AI agents and automated workflows. Unlike consumer-grade providers like Gmail or Outlook, AgentMail focuses on programmatic access, offering features like instant inbox creation, no restrictive rate limits, and structured data extraction. By integrating this into your Openclaw Skills library, you enable your agents to interact with the world through a standard communication protocol without the friction of OAuth or legacy API constraints.
The platform provides agents with a persistent identity and the ability to handle complex email-based tasks such as document processing, customer support, and notification management. It serves as a bridge between the agentic environment and the traditional business world, making it an essential tool for developers building professional-grade AI automations with Openclaw Skills.
AgentMail Use Cases
- Creating dedicated email identities for AI agents to sign up for services or interact with human users.
- Automating high-volume email sending for reports, notifications, or alerts without hitting traditional provider limits.
- Building reactive email workflows where agents process incoming attachments and respond in real-time.
- Integrating email as a trigger for larger multi-agent tasks within the Openclaw Skills framework.
- Replacing complex OAuth-based email integrations with a simple, API-first programmatic alternative.
How AgentMail Works
- The developer or agent creates a programmatic inbox through the AgentMail API or Python SDK using a unique client identifier.
- The agent is assigned a dedicated email address (e.g., agent-name@agentmail.to) which can be used immediately for sending and receiving.
- Incoming emails are captured by the AgentMail infrastructure and forwarded to a configured webhook endpoint as structured JSON payloads.
- A security layer, such as a Clawdbot transform, filters the incoming data against an allowlist to prevent prompt injection attacks.
- The agent processes the structured email content, performs requested tasks, and sends responses as needed using rich text or attachments.
AgentMail Setup
To begin using this skill, follow these installation steps:
- Create an account and generate an API key at console.agentmail.to.
- Install the necessary Python dependencies:
pip install agentmail python-dotenv
- Configure your environment variables in a
.envfile:
AGENTMAIL_API_KEY=your_api_key_here
- You can now register this within your Openclaw Skills configuration to enable agentic email capabilities.
AgentMail Data Schema & Taxonomy
AgentMail organizes email data into a structured format that is easily parsed by LLMs. Below is the primary metadata taxonomy:
| Property | Type | Description |
|---|---|---|
inbox_id |
String | The unique email address for the agent (e.g., assistant@agentmail.to). |
username |
String | The custom prefix used to generate the inbox identifier. |
message.from |
Array | A list of sender objects containing names and email addresses. |
message.subject |
String | The subject line of the incoming or outgoing email. |
message.text |
String | The plain-text version of the email body content. |
attachments |
Array | A list of objects containing filename and base64 encoded content. |
webhook_url |
String | The endpoint where real-time event notifications are delivered. |
AgentMail Advanced Features
- Real-time Webhook Transforms: Use Clawdbot hooks to filter untrusted senders and sanitize input before it reaches the agent.
- High-Volume Infrastructure: Designed for agentic scale with no restrictive rate limits compared to consumer providers.
- Custom Domain Support: Upgrade to use branded email addresses (e.g., assistant@yourcompany.com) for professional Openclaw Skills implementations.
- Semantic Search: Leverage AI-native features to search through historical agent communications using natural language.
- Security Allowlisting: Implement strict sender validation at the gateway level to mitigate prompt injection risks from external emails.
SKILL.md
Loading
Related Openclaw Skills
YouTube Factory
A comprehensive automation skill that transforms a single text prompt into a complete YouTube video with voiceover, footage, and captions.
Clips Machine
An automated workflow for transforming long-form videos into high-engagement, captioned short-form clips for social media.
ohmyopenclaw
A comprehensive collection of AI-native configuration guides designed to automate the setup and optimization of Openclaw Skills for diverse agent architectures.
Homey Smart Home Control
A comprehensive CLI-based skill for controlling Athom Homey smart home devices through local LAN or cloud APIs.
Stealth Browser
The Stealth Browser skill enables undetectable web automation with advanced anti-detection, CAPTCHA solving, and persistent session management.
Hello Test Skill
A lightweight diagnostic skill designed to verify the successful integration and execution of the OpenClaw skill system.
Featured*
