A comprehensive skill enabling AI agents to search, filter, and retrieve email content from Gmail and IMAP accounts via command-line interfaces.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gmailcleanerv2
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 gmailcleanerv2 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 Email Reader?
The Email Reader skill is a specialized tool designed to bridge the gap between AI agents and your inbox. By utilizing either the gog CLI or specialized Python scripts, this Openclaw Skills integration allows your agent to perform read-only operations such as listing recent messages, searching for specific senders, and extracting full conversation threads. It is built with a focus on efficiency and security, ensuring that agents can access the information they need without the risks associated with full write access.
This skill is particularly effective for workflows that require context from past communications or real-time monitoring of specific labels. Whether you are using a standard Gmail account or a custom IMAP server, the Email Reader provides a standardized way for Openclaw Skills to process email data programmatically.
Email Reader Use Cases
- Checking the primary inbox for unread messages or notifications.
- Searching through archives for specific keywords, invoices, or project updates.
- Retrieving the full content of an email thread to provide context for AI summaries.
- Monitoring specific labels or system folders like Sent and Spam.
- Filtering communications by date ranges, attachments, or sender addresses.
How Email Reader Works
- The skill first identifies the available backend, prioritizing the gog CLI for Gmail and falling back to Python scripts if necessary.
- It interprets the user's request to build a precise query using Gmail operators or IMAP search criteria.
- The backend executes the command with optimized flags to ensure data is returned in a structured JSON format.
- It parses the JSON output to extract essential metadata such as Sender, Subject, Date, and Message ID.
- The agent presents a summarized list to the user, offering further actions like reading the full message body or refining the search results.
Email Reader Setup
To get started with the gog CLI backend, install the tool and authenticate your account:
brew install steipete/tap/gogcli
gog auth credentials /path/to/credentials.json
gog auth add $GOG_ACCOUNT --services gmail
For users requiring the Python fallback, install the necessary libraries and run the authentication script to generate your tokens:
pip install google-api-python-client google-auth-oauthlib beautifulsoup4 cryptography
python3 scripts/auth.py
Email Reader Data Schema & Taxonomy
The skill organizes email data into a structured format for easy parsing by Openclaw Skills. The typical data structure includes:
| Property | Description |
|---|---|
| ID / Thread ID | Unique identifiers for referencing specific messages. |
| Sender | The email address and name of the message originator. |
| Subject | The descriptive title of the email. |
| Date/Time | The timestamp for when the message was received. |
| Body/Preview | The textual content or a snippet of the message. |
| Labels | Organizational tags applied to the email (e.g., INBOX, Starred). |
Email Reader Advanced Features
- Intelligent backend detection that automatically switches between gog and Python scripts based on environment availability.
- Support for advanced Gmail search operators like 'newer_than', 'has:attachment', and 'is:unread'.
- Full thread support to reconstruct entire conversations for deeper AI reasoning.
- Encrypted token management for secure, long-term session persistence within Openclaw Skills.
- Flexible IMAP support for non-Gmail providers including Outlook and self-hosted mail servers.
SKILL.md
Loading
Related Openclaw Skills
Email Reader
A powerful skill that allows AI agents to read, search, and manage Gmail messages directly via the gog CLI.
Git Workspace Backup
A specialized automation skill for scheduling directory backups to remote Git repositories using cron or launchd.
OpenClaw Diagnostics
A specialized diagnostic and troubleshooting skill designed to identify and resolve configuration issues within OpenClaw environments.
reMarkable Integration
A powerful integration that syncs handwritten content from your reMarkable tablet to AI workflows for text extraction and sketch refinement.
Flight Tracker
A real-time flight monitoring tool that provides detailed status updates, gate information, and live position data for worldwide aviation.
Flight Tracker
A comprehensive flight tracking tool for monitoring real-time aviation data including delays, gates, and live positions.
Featured*
