se-gmail-monitor

What This Skill Does

The se-gmail-monitor skill provides a robust interface for managing Gmail accounts directly within the OpenClaw environment. It facilitates automated reading, searching, and sending of emails through IMAP/SMTP protocols. Designed specifically for agencies, it handles multiple accounts—including primary, info, and agent aliases—allowing the AI to act as a triage officer. It integrates directly into the heartbeat routine, enabling the agent to monitor inboxes for urgent communications, client leads, or critical security alerts while the user is away.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/boris148/se-gmail-monitor

Ensure that you have generated and saved your Google App Passwords in ~/.openclaw/workspace/.gmail-config.json before initiating the first command. The script relies on this local configuration to authenticate securely with Google's servers without exposing your primary account password.

Use Cases

This skill is perfect for agencies looking to automate their communications workflow. Primary use cases include:

• Automated Email Triage: Automatically scanning incoming emails during heartbeats to identify high-priority messages that require immediate human intervention.
• Operational Efficiency: Managing internal communication channels (e.g., the 'agent' account) for status updates or routine reporting.
• Client Relationship Management: Searching for past correspondence or specific project-related keywords across large email archives.
• Proactive Security: Detecting unauthorized login alerts or service notifications from banks and business platforms.

Example Prompts

• "Check the info inbox for any urgent emails regarding the Acme Corp project that arrived in the last 24 hours."
• "Search for all emails from our developer team that mention the word 'deadline' and summarize them for me."
• "Send a follow-up email to [email protected] using the agent account: 'Just confirming we received your files and are starting the review process now.'"

Tips & Limitations

• Safety First: Always confirm before sending emails. The se-gmail-monitor skill includes a hard rule against sending mail from your primary identity without explicit human approval.
• Account Context: Always specify the account flag (e.g., --account boris) if you have multiple accounts configured to avoid sending information from the wrong persona.
• Configuration: Ensure your .gmail-config.json is properly restricted with file permissions, as it contains sensitive credentials. This skill does not support OAuth2 natively and relies on App Passwords.