Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
New: file attachment support (--attachment), SMTP_SSL (port 465), _retry.py (exponential backoff), setup --cleanup
What This Skill Does
IMAP/SMTP mail client for OpenClaw agents using Python stdlib with no external dependencies. Reads, searches, sends, moves, marks, and deletes messages on any standard mail server. Works with any provider that supports standard IMAP/SMTP, excluding OAuth-only providers.
Uses only Python stdlib with zero external dependencies, so it deploys in restricted environments without any package installation.
When to use it
- Checking unread emails each morning
- Searching for emails by sender, subject, or date
- Sending automated alert emails from monitoring scripts
- Moving messages to archive folders by matching criteria
- Attaching files and reports to outbound emails
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Find all unread emails about invoices and move them to Archive/Invoices
- 1Connects to IMAP server using stored credentials
- 2Searches for unread messages with 'invoice' in the subject
- 3Lists matching messages with UIDs, senders, and subjects
- 4Moves each matching message to the Archive/Invoices folder
Confirmation that matching invoice emails were moved to Archive/Invoices
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.