AgentMail for Openclaw

AgentMail provides a dedicated email inbox for AI agents, enabling them to send, receive, and manage messages programmatically via an @agentmail.to address.

rimelucci
v1.0.0
Feb 5, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install agent-mail

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install agent-mail 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 service designed specifically for the needs of autonomous agents. By assigning a unique email address to an agent, it allows for seamless interaction with human-centric systems that rely on email for verification, notifications, and professional correspondence. This integration is a powerful addition to your collection of Openclaw Skills, providing a bridge between AI logic and traditional communication workflows.

The service offers a developer-friendly experience with a dedicated Python SDK, CLI tools, and a robust REST API. By using AgentMail, agents can independently sign up for services, receive real-time alerts from external systems, and communicate with users or other agents without requiring human intervention for every message exchange.

AgentMail Use Cases

  • Automated account registration and email-based identity verification.
  • Receiving and processing real-time notifications or alerts from third-party services.
  • Professional outreach and status reporting sent directly from the AI agent.
  • Monitoring subscription feeds or marketplace job alerts to trigger autonomous tasks.

How AgentMail Works

  1. The AI agent authenticates with the AgentMail platform using a secure API key.
  2. The agent retrieves a list of messages or waits for real-time notifications via webhooks or cron polling.
  3. Incoming email content is parsed and analyzed by the agent to determine the necessary response or action.
  4. Outbound communications are formatted and sent via the SDK, allowing the agent to maintain its own identity in the email ecosystem.

AgentMail Setup

First, install the required Python library:

pip install agentmail

Next, configure your agent credentials in the local environment:

mkdir -p ~/.agentmail
chmod 700 ~/.agentmail
cat > ~/.agentmail/config.json << 'EOF'
{
  "apiKey": "YOUR_API_KEY",
  "email": "[email protected]"
}
EOF
chmod 600 ~/.agentmail/config.json

AgentMail Data Schema & Taxonomy

AgentMail organizes email data and configuration using a structured JSON format and a clear message taxonomy.

Property Type Description
apiKey String The authentication token for the AgentMail API.
email String The agent's specific @agentmail.to address.
inbox_id String The unique identifier for the mailbox being accessed.
message_id String Unique identifier for individual email items.
from_address String The sender's email address found in message metadata.

AgentMail Advanced Features

  • Real-time response capabilities using webhooks for instant message delivery notifications.
  • Automated polling schedules integrated via Openclaw Skills cron jobs for consistent inbox monitoring.
  • Multi-inbox management allowing a single agent to handle multiple identities or projects.
  • Secure local configuration management using restricted file permissions to protect API keys.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*