gog Skill (OpenClaw): What It Does and How to Install It

Lets an agent read and send Gmail, manage Calendar events and work with Drive, Contacts, Sheets and Docs through the gog command line tool.

Installs: 8.5K; on skills.sh
Stars: 393.6K; on GitHub
Updated: Nov 2026; last repo commit

This skill is in the OpenClaw repository and is written for OpenClaw. It is a list of gog commands and rules, so an agent that loads it can run Gmail searches and sends, Calendar changes, Drive searches, Contacts lists, and Sheets and Docs reads and writes. It can send real email and change real calendars and spreadsheets.

It needs the gog binary and a one-time Google sign-in. SKILL.md says to run the requested command first and enter setup only after an authentication error, and never to ask for passwords, client secrets or refresh tokens in chat.

Good for

People who want an agent to search, draft and send Gmail
Anyone having an agent list or create Google Calendar events
Spreadsheet users who want an agent to read, append or update Google Sheets

Install gog

Claude Code

Copy this prompt.

Install the gog skill in Claude Code. Run this command:

npx skills add https://github.com/openclaw/openclaw --skill gog

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, gog binary.

Pick one route for the skill. The skill needs the gog binary: SKILL.md lists a Homebrew formula named gogcli. After that, set up sign-in once with gog auth credentials and gog auth add, as the skill describes. There is no Claude app upload route because the skill runs a local command line tool.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Key facts

Author: OpenClaw Foundation (repo copyright holder; the skill is bundled in the OpenClaw repo)
Repo: openclaw/openclaw
License: MIT (LICENSE and README badge agree)
Installs on skills.sh: 8,500 (Nov 2, 2026)
GitHub stars: 393,731 for the whole repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn
What it includes: 1 file: SKILL.md
Needs: The gog binary (SKILL.md lists a brew formula, gogcli) and an authorized Google account
Tool site: gogcli.sh (the homepage in SKILL.md frontmatter)

What it includes

gog auth credentials, gog auth add and gog auth list set up Google sign-in once.
SKILL.md example grants gmail, calendar, drive, contacts, docs and sheets.
Runs code · Auth setup
Uses a forwarded callback port or --manual or --remote paste modes.
The operator does the paste steps in a trusted shell, not in chat.
Runs code · Remote or headless sign-in
gog auth list --check and gog auth doctor report token problems.
SKILL.md says to read each reported entry, not just the exit code.
Runs code · Auth diagnostics
gog gmail search and gog gmail messages search with a max count.
Search returns one row per thread; messages search returns each email.
Try: “Find emails from the last 7 days”
Runs code · Gmail search
Sends mail with --body, --body-file (file or stdin) or --body-html.
--body does not unescape \n, so multi-line mail should use --body-file.
Try: “Email a@b.com a follow-up from today's meeting”
Runs code · Gmail send
Creates drafts, sends a draft, or replies with --reply-to-message-id.
Runs code · Gmail drafts and replies
Lists events, creates and updates events, and shows the 11 event colors.
Commands: calendar events, create, update and colors.
Runs code · Calendar
gog drive search "query" with a max result count.
Runs code · Drive search
gog contacts list with a max count.
Runs code · Contacts list
Gets, updates, appends, clears and reads metadata of sheet ranges.
Includes gog sheets clear, which empties a range.
Runs code · Sheets
Exports a doc to a file or prints it.
SKILL.md says in-place Docs edits are not supported by gog.
Runs code · Docs export and cat

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can send email and edit your data
The skill lists gog gmail send, gog gmail drafts send, gog calendar create and update, and gog sheets update, append and clear. Ask Claude to draft first, and approve each send or sheet change yourself. github.com
The sign-in example grants six services
The setup command in SKILL.md passes --services gmail,calendar,drive,contacts,docs,sheets. Grant only the services you need. github.com
Tokens live in a keyring or a password-protected file
SKILL.md says to use the desktop keyring, or gog auth keyring file with GOG_KEYRING_PASSWORD set in the Gateway environment for non-interactive runs. Treat that environment as holding access to your Google account. github.com
Secrets stay out of chat
SKILL.md says never to ask for passwords, client secrets or refresh tokens in chat, and callback URLs must never enter chat or agent tool input. github.com

Technical details

Turning on read-only	SKILL.md documents no read-only mode. Authorize fewer services with --services to limit reach.
Sign-in and keys	OAuth tokens kept by gog in the desktop keyring or a file backend (gog auth keyring file) unlocked with GOG_KEYRING_PASSWORD. Config location follows GOG_CONFIG_DIR, then --home, then GOG_HOME.
Scopes	Reads Gmail, Calendar, Drive, Contacts, Sheets and Docs for the account you authorize Sends Gmail and creates drafts Creates and updates Calendar events Updates, appends to and clears Sheets ranges

Questions

What does the gog skill do?

It lets an agent use the gog command line tool to search and send Gmail, manage Calendar events, search Drive, list Contacts, and read or change Sheets and Docs.

Is this a Google skill?

No. It is in the OpenClaw repository, and gog is a separate command line tool with its own site, gogcli.sh.

How do I install it?

Use the install box at the top of this page for the skill folder. SKILL.md also lists a Homebrew formula, gogcli, for the gog tool, then a one-time sign-in with gog auth credentials and gog auth add.

Does it work outside OpenClaw?

The commands are plain gog commands and the install box covers Claude Code and Codex folders. SKILL.md is written for OpenClaw, and its remote sign-in section talks about an OpenClaw Gateway host.

Does it work in the Claude app?

The install box has no Claude app upload route. The skill runs the gog binary on your machine.

Is it safe?

It can send email and change Calendar and Sheets under your Google account. Authorize only the services you need and approve sends and sheet writes yourself.

Can it edit a Google Doc?

Not in place. SKILL.md says Docs supports export, cat and copy, and that in-place edits need a Docs API client that gog does not include.

Why does it keep asking me to sign in?

SKILL.md says to enter setup only after an authentication error. It suggests checking gog auth list --check and gog auth doctor, and lists a keyring password setting for non-interactive runs.

Information

updated Nov 2, 2026

Repository: openclaw/openclaw
Folder: skills/gog

openclaw/openclaw skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 1

gog SKILL.md · github.com