A robust command-line interface designed for AI agents to create disposable inboxes, monitor incoming mail, and extract message content programmatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agent-email-cli
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 agent-email-cli 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 Agent Email CLI?
The Agent Email CLI skill provides a secure and predictable way for AI agents to interact with email services directly from the terminal. It is built to facilitate automated workflows that require temporary email addresses, such as account registrations, verification code retrieval, and integration testing. By adding this capability to your collection of Openclaw Skills, you enable your agents to handle asynchronous communication tasks without manual oversight.
This skill prioritizes JSON-native output, making it exceptionally easy for LLMs to parse message details like sender addresses, subjects, and timestamps. It emphasizes security by ensuring sensitive credentials like passwords and tokens are never echoed in logs, maintaining a clean and safe operational environment for automated agents.
Agent Email CLI Use Cases
- Automating account creation flows that require email verification codes.
- Monitoring transactional emails during software testing and CI/CD cycles.
- Creating temporary, disposable inboxes for privacy-centric automation tasks.
- Polling for specific messages during long-running background processes.
- Managing multiple mailbox profiles for complex multi-agent coordination.
How Agent Email CLI Works
- Verify the CLI environment and install the required global package if it is missing.
- Initialize a new mailbox account to generate a unique disposable email address.
- Implement polling logic using wait and interval flags to detect new incoming messages.
- Retrieve message summaries or full content payloads for data extraction.
- Process specific messages using unique IDs to view body details or verification links.
- Cleanup the environment by deleting processed messages or removing inactive account profiles.
Agent Email CLI Setup
To utilize this skill, you must install the agent-email package globally via npm or bun. Use the following commands to set up your environment:
npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail
After installation, confirm the CLI is available by running agent-email --help to view the available commands and global options.
Agent Email CLI Data Schema & Taxonomy
The skill manages email data through a structured JSON schema. Below are the primary fields used during mailbox operations:
| Field | Description |
|---|---|
| The active disposable email address | |
| accountId | The unique identifier for the current mailbox profile |
| messageId | A unique string identifying a specific email message |
| subject | The subject line of the received email |
| from.address | The email address of the sender |
| createdAt | The ISO timestamp when the message was received |
Local profiles are stored on the system and can be managed using the accounts list and use commands to switch between different email identities in your Openclaw Skills workflows.
Agent Email CLI Advanced Features
- Intelligent Polling: Configure
--waitand--intervalparameters for efficient real-time inbox monitoring. - Full Payload Retrieval: Access the complete message source and body for deep content analysis.
- Machine-Readable Outputs: Optimized for JSON-native responses to ensure high reliability for AI agent parsing.
- Profile Aliasing: Use the
defaultalias to simplify commands when managing the primary active account. - Automated Troubleshooting: Surfaces detailed error codes and hints to allow agents to self-correct during runtime.
SKILL.md
Loading
Related Openclaw Skills
NervePay
A comprehensive identity and analytics stack for AI agents to cryptographically prove their identity and track external API usage.
NervePay Identity
A cryptographic identity layer for AI agents to register DIDs and securely sign API requests with Ed25519.
NervePay
NervePay provides AI agents with a verifiable cryptographic identity and automated analytics to track external API usage and build a professional reputation.
Text Stats
An efficient text analysis tool for calculating readability scores, word counts, and keyword density with zero dependencies.
Google Docs API Integration
A developer-focused skill for programmatically creating, formatting, and managing Google Documents via the official REST API.
Bring! Shopping List
A high-performance AI agent skill for managing Bring! shopping lists through natural language commands and automated synchronization.
Featured*
