gmail-secretary

What This Skill Does

Gmail Secretary (Alan) is an advanced AI-driven triage agent designed to bring order to chaotic inboxes. It leverages the Haiku LLM to intelligently classify incoming emails based on a user-defined context, ranging from academic responsibilities to extracurricular commitments and administrative tasks. Unlike standard filter-based systems, Alan uses semantic understanding to distinguish between critical project updates for the Mayo Clinic cancer cell simulation and routine newsletters, ensuring that your priority items are surfaced while clutter is relegated to "Read Later."

The skill operates via a structured, multi-step pipeline: it first fetches your inbox, creates summaries, applies intelligent labels using the gog CLI, and finally prepares a digest for your review. Crucially, the system enforces a non-negotiable safety protocol: it never sends emails on your behalf. Instead, it generates drafts and insightful summaries, keeping you in full control of your communication.

Installation

To integrate the Gmail Secretary skill into your OpenClaw environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/officialdelta/gmail-secretary

Ensure that you have the gog CLI utility authenticated with your Gmail account before running the initial triage scripts.

Use Cases

• Student Triage: Automatically sort academic correspondence from Stanton College Prep, including IB/AP class communications, versus extracurricular updates from clubs like FBLA, Medical Society, or Science Fair.
• Project Management: Track high-priority threads related to the Mayo Clinic research project, ensuring no critical data or collaboration requests are missed.
• Account Cleanup: Automatically flag security alerts, password resets, and verification emails with the "Admin / Accounts" label, keeping your main inbox focused on actionable items.
• Personalized Drafting: Maintain a consistent writing voice by using the build-voice-reference.sh script, which analyzes your previous sent messages to help the agent draft new replies that sound like you.

Example Prompts

1. "Alan, fetch my latest emails and generate a triage digest. Focus on any urgent messages regarding the Mayo Clinic project."
2. "Update my voice reference using my last 50 sent messages so my drafts sound more professional for my medical school applications."
3. "Review the inbox, apply the necessary labels, and let me know if there are any pending replies I need to address for my school clubs."

Tips & Limitations

• Voice Maintenance: Periodically run scripts/build-voice-reference.sh to ensure the LLM stays calibrated to your current tone. The system is style-focused and uses snippets rather than a full archive to stay performant.
• Label Strategy: Always favor applying labels over moving or deleting emails. This preserves your ability to find documents later while keeping your inbox clean.
• Draft Review: Since the agent only creates drafts, ensure you review cache/gmail-drafts.md before finalizing any outgoing correspondence. Never assume an auto-generated draft is ready for delivery without human oversight.