gruted-inbox-triage

What This Skill Does

The gruted-inbox-triage skill acts as an intelligent assistant for your communication stream, leveraging the OpenClaw framework to bring order to chaotic email inboxes. It functions as an automated triage layer, connecting to your email provider via either the Himalaya CLI (best for IMAP/local privacy) or the official Google API. Once connected, the skill fetches recent unread emails and employs AI-driven logic to classify them based on urgency, topic, and required intent. It goes beyond simple filtering by pulling relevant calendar events, providing a holistic view of your daily commitments and email demands. The final output is a structured markdown digest that summarizes your inbox, suggests actionable steps for each message, and helps you prioritize your workday without needing to constantly check your mail client.

Installation

To integrate this skill into your OpenClaw environment, execute the command: clawhub install openclaw/skills/skills/gruted/gruted-inbox-triage. After installation, navigate to your workspace directory at ~/.openclaw/workspace/skills/inbox-triage-bot. For users preferring local control without OAuth, ensure you have the Himalaya CLI installed and configured. If you prefer the Google API route, copy the provided .env.example file to .env, supply your unique OAuth credentials, and run the initialization script provided. Once the backend is set, you can run the demo to verify connectivity and generate your first triage report.

Use Cases

• Executive Assistants: Busy professionals use this to identify "must-reply" emails from high-priority clients while ignoring newsletters.
• Project Management: Managers use the daily digest to sync email requests with their upcoming calendar events, ensuring no deadline is missed.
• Inbox Zero Enthusiasts: Individuals leverage the automated triage to clean up their inbox every morning, allowing them to process actionable items in a batch format rather than reacting to notifications all day.

Example Prompts

1. "OpenClaw, run the inbox triage and give me a summary of everything that requires a reply today."
2. "Show me a list of my urgent emails combined with the calendar events I have for the next four hours."
3. "Generate a markdown report of my current inbox and draft a polite decline for any sales emails identified."

Tips & Limitations

• Privacy: If you are concerned about cloud access, the Himalaya backend is highly recommended as it keeps your credentials local.
• AI Accuracy: While AI classification is powerful, always review the "Actionable" items before sending automated replies. It is helpful to set your OpenAI API key in your environment variables to unlock advanced sentiment and urgency analysis.
• Automation: For best results, use the provided cron example to generate your daily digest at 7 AM, ensuring your report is waiting for you before you start work.