AgentMail enables AI agents to send, receive, and manage email communication programmatically through a robust API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agentmail-kessler
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-kessler 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 comprehensive solution for giving AI agents a functional email identity. This integration for Openclaw Skills allows agents to operate within standard email workflows, creating a bridge between LLM logic and traditional communication channels. Whether you need to automate customer service or build a complex email-driven agent network, AgentMail provides the necessary infrastructure for inboxes, pods, and custom domains.
By leveraging the power of Openclaw Skills, developers can implement secure, scalable email operations. The skill supports advanced capabilities like attachment handling, HTML formatting, and thread-based organization, ensuring that agents can participate in professional-grade conversations without manual oversight.
AgentMail Use Cases
- Assigning unique email identities to AI agents for external client communication.
- Automating email-based customer support desk workflows with AI responses.
- Triggering specific agent logic based on incoming emails via real-time webhooks.
- Organizing large-scale agent fleets using pods to manage multiple inboxes and domains.
- Processing and labeling incoming messages to filter for specific intents or urgency.
How AgentMail Works
- The AI agent authenticates with the service using a dedicated API key via the Openclaw Skills interface.
- A programmatic inbox is created, assigning a specific email address to the agent.
- The agent monitors for incoming messages using either long-polling or real-time webhooks.
- Incoming email content is parsed and passed to the agent for processing or reply generation.
- The agent sends responses or creates drafts, maintaining conversation integrity through thread IDs.
AgentMail Setup
Install the AgentMail SDK using pip:
pip install agentmail
Configure your environment with your API key:
export AGENTMAIL_API_KEY="your_api_key_here"
You can also interact with the service using the provided CLI wrapper:
./scripts/agentmail-cli inboxes list
AgentMail Data Schema & Taxonomy
The skill organizes email data into a hierarchical structure for efficient management:
| Object | Description |
|---|---|
| Inbox | The primary email identity (e.g., support@agentmail.to) |
| Pod | A container for grouping multiple inboxes under shared settings |
| Thread | A group of messages belonging to the same conversation |
| Message | The individual unit of communication including body and metadata |
| Draft | A prepared but unsent message awaiting agent approval |
| Webhook | Configuration for pushing events like message.received to external URLs |
AgentMail Advanced Features
- Multi-agent management using Pods for enterprise-scale email automation.
- Custom domain registration and DNS verification for professional agent branding.
- Secure webhook transformations via Openclaw Skills hooks to prevent prompt injection attacks.
- Support for both synchronous and asynchronous Python clients to match agent performance needs.
- WebSocket connectivity for low-latency, real-time event streaming.
SKILL.md
Loading
Related Openclaw Skills
ActiveCampaign Skill
Integrate ActiveCampaign CRM functionality into your AI agent workflows for seamless lead management and automated sales pipelines.
Academic Deep Research
A methodical AI research agent providing exhaustive, multi-cycle investigations with APA-compliant documentation.
Atris
Atris is a codebase intelligence tool that generates structured navigation maps with exact file and line references to eliminate redundant file scanning by AI agents.
Web Automation Service
A comprehensive browser automation tool for form filling, data extraction, and scheduled monitoring.
Amadeus Hotels
A powerful AI agent skill to search hotel availability, compare wholesale prices, and set automated price drop alerts via the Amadeus API.
Apollo.io
Integrate Apollo.io sales intelligence to discover prospects and enrich contact data across 210M+ records.
Featured*
