claw-mail

What This Skill Does

The claw-mail skill is a professional-grade email management system for the OpenClaw agent, designed to provide seamless, multi-account interactions via IMAP and SMTP protocols. It transforms your AI agent into a sophisticated communications hub capable of fetching, reading, searching, composing, replying, and forwarding emails. Beyond basic messaging, it features an IMAP Outbox for reliable delivery, automated conversation threading, and intelligent folder archival using configurable dated-folder structures. Security is a cornerstone of this skill; it enforces TLS 1.2+ connections with hardened ciphers and supports robust authentication methods including OAuth2 and secure credential retrieval from 1Password and the macOS Keychain.

Installation

To integrate claw-mail into your OpenClaw environment, execute the following command in your terminal within your OpenClaw project directory: clawhub install openclaw/skills/skills/borgcube/claw-mail After installation, ensure your account configurations are mapped in the settings file to include your IMAP/SMTP credentials or secure storage paths (e.g., op:// or keychain:// references).

Use Cases

1. Unified Inbox Management: Sync multiple personal and professional accounts to process high-volume emails using global filtering rules.
2. Automated Workflow Integration: Trigger email responses or summaries based on incoming mail, such as acknowledging calendar invites or processing support tickets.
3. Compliance-Ready Correspondence: Use S/MIME signing for secure, authenticated communications in professional settings.
4. Batch Processing: Utilize the mail merge capability for personalized bulk communications while maintaining conversation context.

Example Prompts

1. "Check my primary work account for any unread emails from the project manager and summarize the latest updates regarding the Q2 budget."
2. "Draft a reply to the last email from Sarah Jenkins. Acknowledge receipt of the document, mention that I'll review it by Friday, and ask if she has time for a brief call next week."
3. "Move all newsletters received in the last 30 days to the archive folder and send a follow-up email to the pending invoices thread in my finance account."

Tips & Limitations

• Account Targeting: Always specify --account <name> if you wish to override the default account behavior.
• Security: Avoid hardcoding plain-text passwords; leverage the built-in 1Password or Keychain integration for maximum security.
• Outbox Logic: Remember that the IMAP Outbox acts as a queue; if your network connection drops, the heartbeat script will automatically retry delivery during the next cycle.
• Limits: While the skill supports large mailboxes, complex searches across massive folders may impact latency—consider utilizing specific date ranges in your prompts.