Automatically organize your inbox by creating custom Gmail labels and filters using Openclaw Skills.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install recipe-create-gmail-filter
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 recipe-create-gmail-filter 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 Gmail Filter Creator?
The Gmail Filter Creator is a specialized recipe designed to streamline email management through programmatic inbox organization. By leveraging the gws-gmail integration, this skill allows users and AI agents to define specific rules for incoming messages, ensuring that important emails are labeled, starred, or archived automatically.
This utility is a core component of the Openclaw Skills ecosystem for productivity, providing a reliable way to handle high-volume email environments. It removes the friction of manual sorting by allowing developers to script complex filter actions that trigger based on sender, subject, or content criteria.
Gmail Filter Creator Use Cases
- Automatically labeling incoming receipts and financial statements for easier tracking.
- Moving project-specific communications into dedicated folders to keep the primary inbox clean.
- Archiving and skipping the inbox for low-priority notifications or newsletters using Openclaw Skills.
- Standardizing email workflows across different team accounts to ensure consistent data organization.
How Gmail Filter Creator Works
- The agent first retrieves the current list of labels to verify existing taxonomy or identify missing categories.
- If the required organization structure is missing, the skill creates a new Gmail label via the gws API.
- A filter configuration is defined, specifying the criteria (such as the sender's email) and the intended actions (like adding a label or removing the message from the inbox).
- The filter is applied to the user's account, and a verification step ensures the rule is active and correctly configured within the Openclaw Skills environment.
Gmail Filter Creator Setup
To use this recipe, you must have the gws-gmail skill and the gws binary installed.
# Load the required skill
openclaw skill load gws-gmail
# Ensure your Google Workspace credentials are authenticated
gws auth login
Gmail Filter Creator Data Schema & Taxonomy
The skill interacts with the Gmail API's settings and labels resources. Below is the primary data structure used for filter creation:
| Attribute | Type | Description |
|---|---|---|
userId |
String | The identifier for the user (typically 'me'). |
criteria |
Object | Includes fields like 'from', 'to', and 'subject' to match messages. |
action |
Object | Defines actions such as 'addLabelIds' or 'removeLabelIds'. |
name |
String | The display name for new labels created by Openclaw Skills. |
Gmail Filter Creator Advanced Features
- Support for complex criteria including boolean operators in search queries.
- Multi-action filters that can label, mark as read, and archive messages in a single step.
- Dynamic label creation based on metadata extracted by other Openclaw Skills.
- Scalable filter deployment across multiple authenticated user accounts.
SKILL.md
Loading
Related Openclaw Skills
Real Estate Transaction & Affordability Assistant
A comprehensive AI agent skill for navigating real estate transactions with local-first privacy, affordability analysis, and offer strategy building.
Savings
A comprehensive AI agent skill designed to systematically build and optimize personal savings through goal setting and architectural financial planning.
Coding Assistant
A versatile AI coding partner designed to simplify programming concepts and accelerate the debugging process for developers.
Personal Video DL
A versatile media downloader powered by yt-dlp that supports thousands of video platforms including YouTube, Bilibili, and TikTok.
Budget Pro
A secure, local-first budget management system for tracking expenses and income without connecting to external banks.
Therapy
A compassionate AI agent skill designed to facilitate emotional reflection, session preparation, and therapeutic self-awareness.
Featured*
