gog：面向 AI Agent 的 Google Workspace CLI - Openclaw Skills

下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/gog

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install gog

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 gog。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 gog？

gog 是一款多功能 CLI 工具，旨在桥接终端环境与 Google Workspace 生态系统。它提供了一种结构化方式来与 Gmail、日历、云端硬盘、联系人、表格和文档进行交互，而无需图形界面。该工具对于希望通过脚本或 AI 驱动逻辑实现个人或专业工作流程自动化的开发人员来说价值极高。

通过将此工具整合到您的 Openclaw Skills 库中，您可以让您的 AI Agent 执行复杂的管理任务，例如搜索电子邮件历史记录、管理电子表格数据以及安排会议。它利用 OAuth 进行安全访问，确保与敏感 Google 数据的交互保持受控且经过身份验证。

gog 应用场景

• 通过将联系信息追加到 Google 表格来自动化潜在客户管理。
• 搜索并总结最近的 Gmail 线程，以便快速检索上下文。
• 通过编程方式创建或更新日历活动以进行团队排程。
• 将 Google 文档导出为纯文本，供 LLM 或数据管道摄取。
• 通过命令行脚本在 Google 云端硬盘中管理文件组织和搜索。

gog 工作原理

1. 提供 Google Cloud 客户端密钥 JSON 文件以初始化 OAuth 握手。
2. 为您的 Google 帐号授权特定服务（如 Gmail 或表格）。
3. 使用 gog 二进制文件执行针对性命令以查询或修改 Google Workspace 数据。
4. 利用 JSON 输出标志将结构化数据通过管道传输到其他工具或 AI Agent。
5. 使用环境变量处理多个帐户并简化脚本执行。

gog 配置指南

要开始在 Openclaw Skills 中使用 gog，请通过 Homebrew 安装 CLI：

brew tap steipete/tap
brew install gog

接下来，执行一次性 OAuth 设置：

gog auth credentials /path/to/client_secret.json
gog auth add [email protected] --services gmail,calendar,drive,contacts,sheets,docs

验证您的已认证帐户：

gog auth list

gog 数据架构与分类体系

gog 技能与各种 Google API 交互，并以结构化格式返回数据。以下是核心数据交互的摘要：

服务	主要实体	常见数据格式
Gmail	邮件、线程、搜索结果	文本, JSON
表格	行、单元格范围、元数据	JSON, 用户输入值
云端硬盘	文件、文件夹、元数据	搜索结果列表
日历	活动、时间间隔	ISO-8601 字符串
文档	文档内容	TXT 导出, 原始 Cat 输出
联系人	联系人列表、个人资料	分页列表

name: gog
description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
homepage: https://gogcli.sh
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}}

gog

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.

Setup (once)

• gog auth credentials /path/to/client_secret.json
• gog auth add [email protected] --services gmail,calendar,drive,contacts,sheets,docs
• gog auth list

Common commands

• Gmail search: gog gmail search 'newer_than:7d' --max 10
• Gmail send: gog gmail send --to [email protected] --subject "Hi" --body "Hello"
• Calendar: gog calendar events <calendarId> --from <iso> --to <iso>
• Drive search: gog drive search "query" --max 10
• Contacts: gog contacts list --max 20
• Sheets get: gog sheets get <sheetId> "Tab!A1:D10" --json
• Sheets update: gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Sheets append: gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Sheets clear: gog sheets clear <sheetId> "Tab!A2:Z"
• Sheets metadata: gog sheets metadata <sheetId> --json
• Docs export: gog docs export <docId> --format txt --out /tmp/doc.txt
• Docs cat: gog docs cat <docId>

Notes

• Set [email protected] to avoid repeating --account.
• For scripting, prefer --json plus --no-input.
• Sheets values can be passed via --values-json (recommended) or as inline rows.
• Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
• Confirm before sending mail or creating events.