谷歌工作区命令行工具

技能简介

gogcli 是一款在终端中管理 Google Workspace 服务的命令行工具，覆盖 Gmail、日历、云端硬盘、表格、文档、幻灯片、通讯录、任务、Keep 等常用服务。

能做什么

• 搜索、发送邮件及管理标签
• 查看和创建日历事件
• 列出、上传、下载云端硬盘文件
• 导出表格为 PDF 等格式
• 管理通讯录与待办任务

使用说明

安装（Homebrew）

brew install steipete/tap/gogcli

源码编译安装

git clone https://github.com/steipete/gogcli.git
cd gogcli
make
sudo make install

首次配置 OAuth

1. 访问 Google Cloud Console，创建或选择项目
2. 进入「OAuth 同意屏幕」，创建桌面应用类型客户端
3. 设置重定向 URI 为 http://localhost:8085/callback
4. 启用所需 API，下载 JSON 凭证文件到 ~/Downloads/
5. 执行授权：./bin/gog auth add you@gmail.com ~/Downloads/client_secret_....json
6. 验证：./bin/gog auth list 和 ./bin/gog gmail search 'is:unread' --max 5

常用示例

# Gmail 搜索未读邮件
./bin/gog gmail search 'is:unread' --max 20

# 发送邮件
./bin/gog gmail send 'recipient@gmail.com' --subject '主题' --body '正文'

# 列出日历事件
./bin/gog calendar events list --max 50

# 上传文件到云端硬盘
./bin/gog drive upload ~/Documents/file.pdf

# 导出表格
./bin/gog sheets export <spreadsheet-id> --format pdf

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管 OAuth 凭证 JSON 文件，避免泄露
• 凭证默认存储于 ~/.config/gog/，注意目录权限
• 频繁调用可能触发 Google API 速率限制
• 脚本场景建议加 --json 标志解析输出

来源信息

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