agentmail-cli

What This Skill Does

The agentmail-cli skill provides a powerful command-line interface for the AgentMail API, enabling autonomous agents to manage email operations natively within their workflows. By integrating this skill, your OpenClaw agent gains the ability to provision disposable inboxes, send sophisticated messages with text or HTML content, and poll for incoming communications. It bridges the gap between digital automation and standard communication protocols, allowing agents to handle account verifications, transactional notifications, or collaborative email threads without requiring human intervention.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/stepandel/agentmail-cli

Ensure that you have your AgentMail API key ready from https://agentmail.to. Configuration is critical: either store the key permanently using agentmail config set-key YOUR_API_KEY or export the AGENTMAIL_API_KEY environment variable in your active shell session. Always append the --json flag to commands to ensure your agent can parse the output programmatically.

Use Cases

This skill is ideal for agents performing automated testing or quality assurance where email verification is required. It is also perfect for agents acting as customer support liaisons that need to create temporary tracking emails for specific tasks. Additionally, it streamlines workflows involving automated newsletter management or multi-step processes where external confirmation via email is the only available feedback mechanism.

Example Prompts

1. "Create a new support inbox for the project launch and send an invitation email to [email protected] with an HTML-formatted welcome body."
2. "List the recent messages in my 'support-tasks' inbox and extract the contents of the latest message from the sender '[email protected]'."
3. "Check for new emails in my current inbox; if there is a message with the subject 'Verification Code', extract the code and output it for me."

Tips & Limitations

Always prioritize using the persistent configuration file (~/.agentmail/config.json) over environment variables to avoid auth failures between session restarts. Remember that deleting a message via this API will remove the entire associated thread, which is an irreversible action. When dealing with high-volume tasks, utilize the --limit flag in list operations to prevent your agent from being overwhelmed by large response objects. If your agent consistently encounters authentication errors, verify the configuration state by running agentmail config show before proceeding with further operations.