imap-smtp-email

What This Skill Does

The imap-smtp-email skill empowers your OpenClaw agent to become a full-featured email manager. It bridges the gap between your AI workflow and your inbox, enabling the agent to read, parse, search, and send emails directly. By leveraging the industry-standard IMAP and SMTP protocols, it integrates seamlessly with major providers like Gmail, Outlook, and specialized services like 163.com or QQ Mail. Whether you need to automate your support ticketing, parse incoming invoices, or dispatch automated reports to clients, this skill provides the necessary backend connectivity to handle complex email workflows.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/lroccoon/imap-smtp-email-plus

After installation, locate the skill folder and create a .env file. You must populate this file with your provider-specific credentials. Ensure you follow the SMTP settings guidelines—especially for services like 163.com, which require an authorization code instead of your standard password.

Use Cases

• Automated Triage: Configure your agent to scan the 'INBOX' for unread messages, summarize them, and categorize them based on sentiment or content.
• File Management: Automatically download attachments from specific senders or subject lines into a designated local directory for further processing.
• Newsletter Aggregation: Use search filters to pull emails from specific domains over the last 24 hours to generate a daily digest summary.
• Outbound Communication: Trigger automated follow-ups or confirmation emails when other agent tasks are completed successfully.

Example Prompts

1. "Check my inbox for unread messages from '[email protected]' sent in the last 2 hours and summarize the issues they are raising."
2. "Search for emails with the subject 'Invoice' in the last 7 days, download all PDF attachments to the './invoices' folder, and mark the emails as read."
3. "Send an email to [email protected] with the project status report attached, using the template in the assets folder."

Tips & Limitations

• Security: Always use App Passwords if available, especially with Gmail or Outlook, to avoid storing your primary account password in the .env file.
• Self-Signed Certs: If you are connecting to a private internal mail server with a self-signed certificate, set IMAP_REJECT_UNAUTHORIZED=false in your configuration, but be aware of the security implications.
• Performance: When searching large mailboxes, use specific flags like --recent to limit the scope of the search and improve agent response time.
• Formatting: Keep in mind that email parsing can vary based on whether an email is structured as plaintext or HTML, so ensure your agent is equipped to handle standard content transformation.