Google Services (gog CLI) for Openclaw

A CLI-driven skill for managing Google API authentication and interacting with Gmail, Drive, and Calendar services.

herry3zz
v1.0.0
Feb 26, 2026
0
1.9k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install google-gog

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install google-gog using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Google Services (gog CLI)?

The Google Services skill utilizes the gog CLI to provide a robust interface for managing Google OAuth 2.0 credentials and service interactions. As a core component of the Openclaw Skills ecosystem, it simplifies the complexities of token lifecycles by offering transparent background refreshes and secure storage within the OS Keyring. This allows developers and automated agents to interact with Google APIs without manual intervention for credential updates.

By integrating this skill, users can execute high-level commands for Gmail and Drive, such as searching emails or uploading files, directly through a unified command-line interface. It is designed for both local development environments and headless server configurations, making it a versatile tool for any developer utilizing Openclaw Skills for automation.

Google Services (gog CLI) Use Cases

  • Automating email workflows by sending or searching Gmail messages via CLI scripts.
  • Synchronizing local files with Google Drive through automated upload and download commands.
  • Managing multiple Google account tokens with secure, encrypted storage in the system keyring.
  • Setting up headless API interactions for cron jobs or CI/CD pipelines using file-based keyring backends.

How Google Services (gog CLI) Works

  1. The user provides a Google Cloud client secret file to initialize the authentication bridge.
  2. The gog CLI is used to authorize specific scopes like Gmail, Drive, or Calendar, storing the resulting tokens securely.
  3. Openclaw Skills leverage the CLI to perform API calls, which automatically handle token refresh logic if the current session has expired.
  4. Commands are passed through the gog interface to interact with Google's REST APIs, returning structured data or performing file operations.

Google Services (gog CLI) Setup

To begin using this skill within your Openclaw Skills environment, ensure your client secret is placed in the correct directory.

  1. Place your client_secret.json in ~/.openclaw/credentials/.
  2. Authenticate your account and authorize services:
gog auth add [email protected] --services gmail,drive,calendar --manual --force-consent
  1. For headless automation, configure the keyring environment variables:
export GOG_KEYRING_BACKEND=file
export GOG_KEYRING_PASSWORD=your_secure_password
gog auth list --check

Google Services (gog CLI) Data Schema & Taxonomy

The skill organizes its configuration and sensitive data as follows:

Component Path / Method Description
Client Credentials ~/.openclaw/credentials/client_secret.json The primary JSON file obtained from the Google Cloud Console.
OAuth Tokens OS Keyring / File Encrypted storage of access and refresh tokens for authorized accounts.
Service Scopes CLI Metadata Defines access levels for Gmail, Drive, and Calendar APIs.

Google Services (gog CLI) Advanced Features

  • Support for manual and automatic force-consent triggers to ensure refresh tokens are always granted.
  • Multi-service scope management allowing simultaneous access to Gmail, Drive, and Calendar.
  • Headless mode compatibility for Openclaw Skills running in containerized or server environments.
  • Health check commands to verify token validity and expiration status before initiating complex workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*