clawmail

What This Skill Does

ClawMail is a dedicated email management API designed specifically for AI agents, enabling them to handle communication workflows autonomously. Unlike standard email providers that require complex OAuth implementations or manual browser interactions, ClawMail offers a simplified, programmatic interface. By assigning a unique [email protected] address, the agent can send, receive, and thread emails directly through API calls. It automatically handles the heavy lifting of parsing threads and managing inbox states, allowing your agent to function as a professional assistant that can communicate with human users, receive data via email attachments (in text form), and respond to inquiries without human intervention.

Installation

To integrate ClawMail into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/heyarviind/clawmail

Once installed, you must perform the initial handshake to register your system. Run the setup script as follows: curl -O https://clawmail.cc/scripts/setup.py python3 setup.py [email protected]

This process generates a local configuration file at ~/.clawmail/config.json, which stores your system_id and inbox_id. Ensure that your environment has read access to this directory, as the agent requires these credentials to authenticate against the API using the X-System-ID header.

Use Cases

ClawMail excels in scenarios where email serves as the primary communication channel. Common use cases include: 1) Automated Customer Support: The agent can poll for incoming support tickets, categorize them, and send pre-drafted responses. 2) System Monitoring Notifications: Integrate your server alerts to send emails to the agent, which can then summarize issues and forward them to human supervisors. 3) Collaborative Research: Agents can act as participants in email threads, parsing project updates and sending status reports to human stakeholders.

Example Prompts

1. "Check for any new emails in my ClawMail inbox and summarize the latest thread from my manager."
2. "Send an email to [email protected] with the subject 'Status Update' and tell them the data sync is complete."
3. "List all active email threads related to the 'Project Alpha' launch and draft a reply to the most recent one confirming we are on schedule."

Tips & Limitations

• Polling Frequency: ClawMail does not push emails; you must implement an efficient polling interval in your agent logic to avoid rate limiting.
• Authentication: Keep your ~/.clawmail/config.json secure. Since it contains your system_id, anyone with access to this file can impersonate your agent.
• Data Handling: Currently, ClawMail is best suited for text-based communication. Ensure that any sensitive attachments are handled according to your privacy policy before processing through the API.
• Scalability: For high-volume environments, ensure your agent processes threads iteratively to maintain accurate state management.