gws-gmail

What This Skill Does

The gws-gmail skill serves as a comprehensive interface between OpenClaw and your Google Gmail account. It enables agents to act as intelligent email assistants, allowing for seamless reading, drafting, sending, and management of email communications. By utilizing the Gmail API under the hood, the skill provides programmatic access to user profiles, message threads, labels, and settings, effectively turning your email inbox into a programmable workspace.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-gmail. Ensure that you have already configured your authentication and security prerequisites by referencing ../gws-shared/SKILL.md. If these configurations are missing, run gws generate-skills to establish the necessary handshake protocols with Google Workspace.

Use Cases

This skill is highly versatile for automation and productivity tasks. Use it to automatically triage incoming support tickets, notify external systems of status changes, or synthesize lengthy email threads into concise summaries for your daily briefing. Developers can also use the +watch helper command to monitor incoming mail in real-time, streaming data as NDJSON to downstream pipelines, making it an ideal choice for building notification-driven workflows or AI-powered auto-responders.

Example Prompts

1. "Check my inbox for any urgent emails from my manager sent in the last hour and summarize them for me."
2. "Draft a polite response to the last email in the 'Invoices' thread confirming receipt and letting them know it will be processed by Friday."
3. "Triage my current inbox and list the sender and subject for all unread messages from the last 24 hours."

Tips & Limitations

Always inspect method schemas using gws schema gmail.<resource>.<method> before attempting to pass parameters, as this ensures your JSON payloads match the expected API structure. Be mindful of Gmail API rate limits, especially when utilizing the +watch or heavy polling methods. Note that this skill does not store your emails locally; it interacts directly with the Gmail servers, meaning performance is subject to network latency. Ensure your OAuth scopes have been granted the appropriate permissions for reading and writing to avoid authorization errors during execution.