Setup & Installation
openclaw skills install @r39132/gmail-agent
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install gmail-agent
What This Skill Does
Manages a Gmail inbox by summarizing unread messages, displaying the full label hierarchy with message counts, purging spam and trash, and auditing or cleaning specific label trees.
Combines inbox summarization, label auditing, and folder cleanup into one agent so you don't need to open a browser or run multiple tools separately.
When to use it
- Check what's new in your inbox each morning
- See a breakdown of all Gmail labels and folder sizes
- Bulk-delete accumulated spam and trash
- Audit a label hierarchy before removing old categories
- Run a daily scheduled summary and inbox cleanup
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Summarize my unread emails
AGENT
- 1Searches Gmail for unread inbox messages using gog
- 2Fetches full message details for any items needing more context
- 3Groups messages by sender when multiple arrive from the same address
- 4Formats results into a structured summary with sender, subject, and date
OUTPUT
A grouped list of unread inbox messages; if over 20 messages, a per-sender count breakdown instead
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
gog binary installedGMAIL_ACCOUNT environment variable set to your Gmail address