OpenClaw Skills Gog 命令行工具技能

gog 是用于操作 Gmail、日历、云端硬盘、联系人、表格、文档 的命令行工具，必须先完成 OAuth 授权配置才能使用。

👤 作者：Peter Steinberger

👉 Skills 下载地址：gog-1.0.0.zip

初始化配置（仅首次使用需要）

## 1. 导入 Google OAuth 凭证文件（需在 Google 开发者平台提前创建）
gog auth credentials /path/to/client_secret.json


## 2. 为你的邮箱授权，并开启需要使用的服务（多个服务用英文逗号分隔）
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs


## 3. 查看已授权的所有账号
gog auth list

常用命令大全

## ==================== Gmail 操作 ====================
## 搜索邮件：查找7天内的邮件，最多显示10条
gog gmail search 'newer_than:7d' --max 10


## 发送邮件：指定收件人、邮件标题、正文内容
gog gmail send --to a@b.com --subject "Hi" --body "Hello"




## ==================== 日历操作 ====================
## 查询日历事件：指定日历ID、开始时间、结束时间（ISO格式）
gog calendar events <日历ID> --from <ISO时间> --to <ISO时间>




## ==================== 云端硬盘操作 ====================
## 搜索云端硬盘文件：按关键词查询，最多返回10条结果
gog drive search "query" --max 10




## ==================== 联系人操作 ====================
## 列出联系人：最多显示20个联系人
gog contacts list --max 20




## ==================== 表格操作 ====================
## 读取表格数据：获取指定表格中工作表 A1:D10 区域，输出 JSON 格式
gog sheets get <表格ID> "Tab!A1:D10" --json


## 更新表格数据：修改指定区域内容，使用 JSON 格式传入数据
## --input USER_ENTERED：按用户输入格式解析数据
gog sheets update <表格ID> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED


## 追加表格数据：在指定区域末尾插入新行数据
## --insert INSERT_ROWS：自动插入新行
gog sheets append <表格ID> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS


## 清空表格数据：清空指定区域的内容
gog sheets clear <表格ID> "Tab!A2:Z"


## 获取表格元数据：查看表格信息、工作表列表，输出 JSON 格式
gog sheets metadata <表格ID> --json




## ==================== 文档操作 ====================
## 导出文档：将文档导出为 txt 格式，保存到指定路径
gog docs export <文档ID> --format txt --out /tmp/doc.txt


## 查看文档：在终端直接打印文档内容
gog docs cat <文档ID>

使用注意事项

## 1. 设置环境变量，避免每次命令都输入 --account 参数
export GOG_ACCOUNT=you@gmail.com


## 2. 编写脚本时推荐使用：
## --json：输出结构化数据
## --no-input：禁用交互式确认，自动化执行
gog ... --json --no-input


## 3. 表格数据优先使用 --values-json 参数传入（推荐，更稳定）

设置环境变量 GOG_ACCOUNT=you@gmail.com，可以避免重复输入 --account 参数。
脚本编写：推荐使用 --json 格式输出 + --no-input 关闭交互模式。
表格数据推荐通过 --values-json 传入（官方推荐方式）。
文档支持：导出、查看、复制；不支持在线编辑（需使用 Docs API 客户端）。
安全提醒：发送邮件、创建日历事件前，工具会弹出确认提示，需要手动确认。

补充说明

官方地址：https://clawhub.ai/steipete/gog
适用平台：macOS / Linux / Windows
安装方式：brew install steipete/tap/gogcli