gmail-agent

What This Skill Does

The gmail-agent skill is a powerful automation tool designed to streamline your email management workflow within OpenClaw. It serves as an intelligent intermediary between you and your Gmail account, allowing for efficient inbox processing, label auditing, and maintenance. By leveraging advanced search queries, the agent can differentiate between standard inbox filtering and global unread summaries, ensuring you only process the information relevant to your current needs. It provides a structured overview of your email landscape, including granular visibility into folder structures and label-based message counts, making it an essential utility for maintaining 'Inbox Zero' and organizing your digital communication.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/r39132/gmail-agent Ensure that your environment variable GMAIL_ACCOUNT is correctly configured with your authenticated email account credentials before attempting to execute skill commands.

Use Cases

Use this skill when you need to quickly scan through high volumes of unread emails without navigating the web interface. It is particularly useful for users managing multiple labels or those who want to perform routine maintenance, such as purging spam and trash folders periodically. The agent is ideal for users who prefer text-based summaries and data-driven insights into their inbox density rather than visual distractions.

Example Prompts

1. "Summarize my unread emails in the inbox please."
2. "Can you show me a breakdown of all my Gmail labels and how many messages are in each?"
3. "Summarize all my unread emails, including those outside of the primary inbox."

Tips & Limitations

• Default Mode: The skill defaults to 'inbox only' for speed. If you need a comprehensive scan, you must explicitly use the word 'all'.
• Scalability: If you have more than 20 unread messages, the agent intelligently switches from listing individual items to grouping them by sender to avoid information overload.
• Security: The agent interacts directly with your account using your configured identity; ensure your environment variable access is restricted to authorized processes only.
• Maintenance: Always run the label audit tool before performing heavy deletions to ensure you are not discarding vital threads categorized under specific labels.