clawemail

What This Skill Does

The clawemail skill integrates your OpenClaw AI agent with the full Google Workspace suite via the ClawEmail service. It provides a bridge to manage your Gmail inbox, Google Drive files, Docs, Sheets, Slides, Calendar events, and Forms. By authenticating through the ClawEmail platform, your agent can perform actions on your behalf, effectively acting as an automated digital assistant for your daily workflow, communication, and document organization.

Installation

1. Install the skill via terminal: clawhub install openclaw/skills/skills/cto1/clawemail.
2. Create an account at https://clawemail.com and visit the /connect/YOUR_PREFIX endpoint to authorize OAuth access for your Google account.
3. Save the provided credentials JSON to ~/.config/clawemail/credentials.json.
4. Set the environment variable CLAWEMAIL_CREDENTIALS in your shell configuration pointing to that file.
5. Note: Always initialize your authentication token before running commands using the provided helper script: TOKEN=$(~/.openclaw/skills/clawemail/scripts/token.sh).

Use Cases

• Email Automation: Compose, send, reply to, and search emails within your Gmail account.
• File Management: Organize, create, and retrieve documents across Drive, Sheets, and Docs.
• Scheduling: Query calendar events or schedule new meetings.
• Data Handling: Parse email content or extract data from forms and spreadsheets directly through the agent interface.

Example Prompts

1. "Check my inbox for any urgent emails from my manager about the quarterly project and summarize the latest one."
2. "Draft a reply to the last email from [email protected] confirming that the project files are uploaded to our shared Drive folder."
3. "Schedule a meeting on my calendar for next Tuesday at 2 PM with the team to discuss the Q3 roadmap."

Tips & Limitations

• Token Management: The authentication token expires after 50 minutes. If you receive an unauthorized error, re-run the token script.
• Security: This skill uses OAuth scopes; verify the requested permissions at the ClawEmail dashboard to ensure you are comfortable with the level of access provided.
• Data Privacy: Be mindful that the agent has read/write access to your emails and files; use caution when allowing the agent to send sensitive information.
• Error Handling: When sending emails with attachments or HTML, ensure your raw base64 encoding follows standard RFC 2822 formatting to prevent delivery failures.