gws-gmail-send

What This Skill Does

The gws-gmail-send skill is a powerful automation tool for OpenClaw that enables users to send emails directly via the Gmail API. This skill streamlines communication workflows by abstracting the complexities of RFC 2822 formatting and base64 encoding. By integrating this skill, the agent can compose and dispatch emails autonomously based on trigger events or user instructions. It functions as a secure bridge between your AI agent and your Gmail account, ensuring that messages are sent with appropriate authorization and structured formatting. This is designed for high-level interaction, allowing users to delegate email tasks without needing to manually log into their inbox.

Installation

To begin using this skill, ensure that you have initialized your OpenClaw environment by running gws generate-skills. This confirms that all shared authentication dependencies found in ../gws-shared/SKILL.md are correctly configured. Once your auth is verified, you can install the skill by executing: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-gmail-send. Always verify that your agent has the necessary OAuth scopes to perform the 'send' operation to avoid runtime permission errors.

Use Cases

This skill is ideal for professional and personal automation. Common use cases include: sending automated status reports to team members, distributing summarized research findings to stakeholders, sending personalized follow-up emails after client meetings, and triggering alerts for monitored system events. Because the skill handles encoding automatically, it is perfect for rapid prototyping of communication tasks where simple plain-text messages are required.

Example Prompts

1. "Send an email to [email protected] with the subject 'Weekly Project Status' and the body 'Hi team, the current project status is on track for this week.'"
2. "Could you send a summary of these research notes to my supervisor at [email protected] using the subject 'Research Briefing' and include the points we just discussed?"
3. "Email [email protected] letting her know that I have received her file and I will review it by the end of the day."

Tips & Limitations

The gws-gmail-send skill is optimized for speed and simplicity. It handles the nuances of Gmail messaging protocols automatically, significantly reducing overhead. However, be aware of its limitations: this version does not natively support attachments, CC/BCC fields, or HTML-formatted bodies. If your requirements involve rich text, complex attachments, or multi-recipient threads, you should pivot to the raw API command: gws gmail users messages send --json. Always confirm with the user before executing, as this skill performs a write action on your personal account.