gog

What This Skill Does

The gog skill acts as a robust Command Line Interface (CLI) bridge to the Google Workspace ecosystem. It empowers OpenClaw agents to perform complex operations across Gmail, Google Calendar, Google Drive, Google Contacts, Google Sheets, and Google Docs. By streamlining authentication via OAuth, it provides a secure and programmatic way to manage your digital environment, from automating email responses and calendar scheduling to complex data manipulation within spreadsheets and document exports. It serves as an essential utility for users who rely on the Google ecosystem for their daily productivity and project management needs.

Installation

To integrate this skill into your environment, use the OpenClaw management utility via your terminal: clawhub install openclaw/skills/skills/fionn1989/gog2

Post-installation, you must initialize your authentication credentials. Download your client_secret.json from the Google Cloud Console, then run:

1. gog auth credentials /path/to/client_secret.json
2. gog auth add [email protected] --services gmail,calendar,drive,contacts,sheets,docs
3. Verify your configuration with gog auth list.

Use Cases

This skill is designed for high-efficiency workflows. You can use it to automate routine email sorting, generate calendar invites based on data extracted from external triggers, or maintain live data synchronization between local processes and Google Sheets. Furthermore, it is ideal for batch processing document exports to various formats and performing structured data analysis by querying sheets directly through the CLI.

Example Prompts

1. "Check my inbox for unread emails from the last 24 hours and summarize them for me using the gog gmail search command."
2. "Add a new row to my 'Expenses' sheet using the latest data from this JSON output: [["Office Supplies", "50.00"]]."
3. "Export my Q3 Project Report document to a text file and save it in my temporary directory."

Tips & Limitations

To maximize performance, set the GOG_ACCOUNT environment variable to your primary email address; this eliminates the need to append the --account flag to every command. When building scripts, always utilize the --json flag paired with --no-input to ensure your workflows execute without hanging on user confirmation prompts. Note that while you can read and export documents, in-place document editing requires native Docs API client integration. Always double-check automated email and calendar creation, as these actions cannot be easily reverted once executed.