谷歌工作区命令行工具

技能简介

gog 是一款面向 Google Workspace 的命令行工具，支持在终端直接操作 Gmail、日历、云端硬盘、通讯录、表格和文档，适合需要批量处理或脚本化管理的用户。

业务背景

IT运维、行政等需批量处理Workspace数据的团队，可在终端完成邮件筛选、日程导出、文件归档等重复工作。命令行方式便于写入自动化脚本，减少人工逐条操作的耗时与遗漏风险。

落地案例：财务月末需汇总各部门提交的报销单据表格，管理员通过命令行批量下载云端硬盘指定文件夹内的所有表格文件，再统一导入内部系统进行核对；全程无需逐个打开浏览器下载，处理效率显著提升。

能做什么

• 搜索、发送邮件，管理 Gmail 收件箱
• 查询日历事件，导出日程数据
• 搜索、下载云端硬盘文件
• 列出通讯录联系人
• 读取、更新、追加、清空表格数据
• 导出或查看文档内容

使用说明

安装（macOS/Linux）

brew install steipete/tap/gogcli

首次配置 OAuth

1. 从 Google Cloud Console 下载 client_secret.json
2. 执行 gog auth credentials /path/to/client_secret.json
3. 添加账号：gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs
4. 验证：gog auth list

常用命令示例

# Gmail 搜索近7天邮件
gog gmail search 'newer_than:7d' --max 10

# 发送邮件
gog gmail send --to a@b.com --subject "Hi" --body "Hello"

# 查询日历事件
gog calendar events primary --from 2024-01-01T00:00:00Z --to 2024-01-31T23:59:59Z

# 云端硬盘搜索
gog drive search "project report" --max 10

# 表格读取
gog sheets get <sheetId> "Sheet1!A1:D10" --json

# 表格更新
gog sheets update <sheetId> "Sheet1!A1:B2" --values-json '[["A","B"],["1","2"]]'

# 文档导出为文本
gog docs export <docId> --format txt --out /tmp/doc.txt

环境变量：设置 GOG_ACCOUNT=you@gmail.com 可省略 --account 参数；脚本场景建议加 --json --no-input。

输入与输出

见下方输入与输出表格。

风险提示

• 需自行申请 Google Cloud OAuth 凭据并完成授权流程
• 发送邮件或创建事件前会提示确认，避免误操作
• 文档仅支持导出/查看，不支持原地编辑
• 账号凭证存储于本地，注意文件权限安全

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/gog/SKILL.md
来源类型：GitHub 仓库