A robust Gmail automation tool that triages your inbox by archiving low-priority marketing emails while surfacing critical communications.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install email-processor
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 email-processor 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 Processor?
The Email Processor skill leverages the gog CLI and Google Cloud OAuth to provide programmatic control over your Gmail inbox. It is designed to handle the heavy lifting of reaching inbox zero by intelligently filtering out promotions, newsletters, and cold pitches based on system labels. By integrating with Openclaw Skills, users can automate repetitive triage tasks that usually consume significant manual effort, ensuring that only high-priority messages remain in focus.
Email Processor Use Cases
- Processing hundreds of unread emails in seconds to clear out backlog.
- Automatically marking newsletters and marketing promotions as read to reduce daily clutter.
- Isolating and surfacing critical GitHub notifications, security alerts, and direct messages.
- Generating a high-level summary of daily inbox activity for quick review.
How Email Processor Works
- The skill utilizes the gog CLI to fetch metadata for all threads currently marked as unread from the connected Gmail account.
- It analyzes Gmail system labels such as CATEGORY_PROMOTIONS and identifies custom patterns like Superhuman AI filters.
- Low-priority threads are identified and modified in batches to remove the UNREAD status.
- Important emails, such as those related to finance or security, are preserved to ensure they are not missed.
- The skill produces a summary report detailing exactly which emails were processed and which require manual attention.
Email Processor Setup
Install Prerequisites
Install the gog CLI via Homebrew and verify the installation:
brew install steipete/tap/gogcli
gog --version
Google Cloud Configuration
- Enable the Gmail API in your Google Cloud Console project.
- Create OAuth client ID credentials for a Desktop app and download the JSON file.
Authentication
Configure the gog CLI with your credentials and link your Gmail account:
gog auth credentials /path/to/client_secret.json
gog auth add [email protected] --services gmail
Email Processor Data Schema & Taxonomy
The skill interacts with the Gmail API via gog, targeting specific thread metadata and label structures. Below are the primary labels processed during the Openclaw Skills automation:
| Label Group | Description |
|---|---|
| CATEGORY_PROMOTIONS | Standard Gmail label for marketing content |
| [Superhuman]/AI/News | Custom label often used for recurring newsletters |
| UNREAD | The primary filter used to identify new incoming mail |
| Thread ID | The unique identifier used for batch modification operations |
Email Processor Advanced Features
- Batch processing capabilities using jq for high-speed metadata filtering and identification.
- Support for Superhuman AI labels, allowing users to leverage advanced AI-driven organization within their automated workflows.
- Custom script integration which allows the processor to be triggered via cron jobs or other system-level automations.
- Multi-account support via the gog CLI's robust authentication profile management.
SKILL.md
Loading
Related Openclaw Skills
YouTube Watcher
Fetch and process YouTube video transcripts for instant summarization and content analysis.
YouTube Watcher
An essential skill for fetching and reading YouTube video transcripts to enable AI-driven summarization and information retrieval.
x-trends
A powerful CLI-driven skill to search, filter, and analyze real-time trending topics and hashtags on X (Twitter) across global locations.
wacli
A robust command-line interface for sending WhatsApp messages, searching chat history, and automating third-party communications.
OpenViking MCP Server
A high-performance Model Context Protocol server providing Retrieval-Augmented Generation (RAG) and semantic search tools for AI agents.
OpenViking
A next-generation RAG system that uses a filesystem paradigm to manage AI agent memories, resources, and skills.
Featured*
