A lightweight, zero-dependency IMAP and SMTP client designed for AI agents to read, search, and send emails securely.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mail-client
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mail-client using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Mail Client?
The Mail Client is a robust communication tool built specifically for Openclaw Skills, allowing agents to interact with standard mail servers using IMAP for reading and SMTP for sending. Written in pure Python with no external dependencies, it ensures high compatibility and security for any standard mail provider.
This skill empowers AI agents to handle diverse email-related tasks, from summarizing unread messages and searching for specific invoices to sending automated alerts with HTML bodies and file attachments. It provides a secure way to manage credentials and granularly control permissions like sending, reading, and deleting via a local configuration file, making it a safe choice for automated communication.
Mail Client Use Cases
- Monitoring unread messages and summarizing key information for daily digests.
- Automating the delivery of system alerts, reports, or notifications with file attachments.
- Organizing mailboxes by searching for specific criteria and moving messages to archive folders.
- Integrating email capabilities into larger AI workflows, such as sending meeting summaries after a calendar event.
How Mail Client Works
- The agent initializes the MailClient using credentials stored in a secure local secrets file or environment variables.
- The skill connects to the specified IMAP server to fetch folder lists, search for messages, or retrieve specific email contents based on trigger phrases.
- For outgoing communication, it utilizes the SMTP protocol to dispatch plain text or HTML emails, including handling optional file attachments.
- All actions are filtered through a capability-based configuration, ensuring the agent only performs allowed operations like reading or deleting according to user-defined permissions.
Mail Client Setup
Follow these steps to integrate this skill into your Openclaw Skills environment:
- Run the interactive setup wizard to configure your SMTP/IMAP hosts and credentials:
python3 scripts/setup.py
- Validate the configuration to ensure the agent can connect to your mail server successfully:
python3 scripts/init.py
- Enable specific capabilities such as send, read, search, or delete by editing the configuration file at
~/.openclaw/config/mail-client/config.json.
Mail Client Data Schema & Taxonomy
The skill manages data across two primary locations to separate secrets from behavioral configuration within the Openclaw Skills ecosystem:
| Path | Purpose | Sensitive |
|---|---|---|
~/.openclaw/secrets/mail_creds |
Stores SMTP/IMAP hosts, users, and app keys. | Yes |
~/.openclaw/config/mail-client/config.json |
Defines allowed capabilities, ports, and default folders. | No |
Metadata includes fields for sender information, subject lines, message UIDs for precise tracking, and IMAP folder structures.
Mail Client Advanced Features
- Zero external dependencies using only the Python standard library for maximum portability and security.
- Full support for both plain text and HTML email bodies with multi-file attachment capabilities.
- Granular permission controls to restrict agents from destructive actions like deleting emails or moving folders.
- Environment variable precedence allows for easy integration into containerized or CI/CD environments using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
GitHub Watch
Automate weekly GitHub repository discovery and LLM-powered scoring for DevOps and SysOps professionals.
Ghost CMS
Effortlessly manage Ghost CMS content, from drafting blog posts to organizing tags and members, through the Ghost Admin API.
Alby Bitcoin Payments CLI
A comprehensive command-line interface for managing Bitcoin Lightning wallet operations through the Nostr Wallet Connect (NIP-47) protocol.
me-txt
A standardized personal identity protocol that allows AI agents to understand your persona, work, and preferences via a simple markdown file.
Nextcloud
A comprehensive Nextcloud integration for Openclaw Skills that enables AI agents to manage files, folders, and metadata via WebDAV and OCS APIs.
Veille
A modular RSS aggregator for AI agents that fetches, deduplicates, and scores news articles using LLMs.
METADATA
Featured*
