gmail-inbox-zero

What This Skill Does

The gmail-inbox-zero skill is an intelligent, AI-powered assistant designed to help you regain control of your digital life. By leveraging the power of the gog CLI, this tool transforms your overwhelming Gmail inbox into an interactive triage system within Telegram. Instead of manually clicking through hundreds of emails, the agent summarizes your inbox messages in concise, one-line descriptions. You can then quickly queue actions—archiving, filtering, or unsubscribing—using convenient inline buttons. Once you have made your decisions, a single 'Done' action executes all your queued requests in a batch, ensuring you reach Inbox Zero with minimal effort and maximum efficiency. It is designed for privacy, utilizing OAuth-based authentication so your credentials remain secure throughout the process.

Installation

To begin, ensure you have the OpenClaw agent installed and configured. Install the skill using the following terminal command: clawhub install openclaw/skills/skills/poisondminds/gmail-inbox-zero-triage

Ensure that the gog CLI is installed and your Gmail account is authenticated. You can verify this by running gog auth list. If you haven't set it up yet, use gog auth add. Finally, set your environment variable for the keyring password via export GOG_KEYRING_PASSWORD="your-password" to allow the agent to interface with your mail safely.

Use Cases

This skill is perfect for professionals drowning in newsletters, promotional emails, and unread notifications. It is ideal for periodic "inbox clear-outs," enabling users to process massive amounts of email during their commute or coffee break without needing to open the Gmail application. It also serves as a robust tool for cleaning up junk mail through the integrated filter and unsubscribe functionality.

Example Prompts

1. "I'm feeling overwhelmed, please triage my emails and help me get to inbox zero."
2. "Can you process my inbox? I want to archive the junk and unsubscribe from the newsletters."
3. "Triage my Gmail and summarize what's important so I can quickly clear out the noise."

Tips & Limitations

To get the most out of this tool, process your emails in batches of 20 to avoid overwhelming the interface. If an email is critical, use the 'View' button to inspect the full content before taking action. Please note that while the filter and archive actions are automated, the unsubscribe feature may occasionally require you to interact with a specific website link if the automated process cannot locate the header. Always double-check your filters periodically to ensure you aren't accidentally hiding important correspondence.