名称：gogcli 描述：用于Gmail、日历、云端硬盘、表格、文档、幻灯片、联系人、任务、用户、群组和Keep的Google Workspace命令行界面。当用户要求与Google服务交互时使用。

gogcli - Google Workspace 命令行工具

概述

gogcli 是一款用于从终端管理 Google Workspace 服务的命令行工具。支持 Gmail、日历、云端硬盘、表格、文档、幻灯片、联系人、任务、用户、群组和 Keep。

安装

快速安装（如果您有 brew）：

brew install steipete/tap/gogcli

从源代码构建（无 brew）：

# 1. 克隆仓库
git clone https://github.com/steipete/gogcli.git

# 2. 进入目录
cd gogcli

# 3. 构建
make

# 4. （可选）全局安装
sudo make install

首次设置

在使用 gogcli 之前，请设置 OAuth 凭据：

步骤 1：获取 OAuth 客户端凭据

1. 前往 Google Cloud Console API 和服务
2. 创建项目或使用现有项目
3. 前往 OAuth 同意屏幕
4. 创建 OAuth 2.0 客户端，设置如下：
   • 应用程序类型："桌面应用"
   • 名称："gogcli for Clawdbot"
   • 已授权的重定向 URI：http://localhost:8085/callback
5. 启用您需要的 API
6. 下载 OAuth 客户端凭据 JSON 文件
7. 复制到~/Downloads/

步骤 2：授权您的账户

cd gogcli
./bin/gog auth add you@gmail.com ~/Downloads/client_secret_....json

第三步：验证

./bin/gog auth list
./bin/gog gmail search 'is:unread' --max 5

常用命令

Gmail

# 搜索
./bin/gog gmail search '查询词' --max 20

# 发送
./bin/gog gmail send '收件人@gmail.com' --subject '主题' --body '邮件内容'

# 标签
./bin/gog gmail labels list

日历

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

# 创建事件
./bin/gog calendar events create '会议' --start '2026-01-30T10:00'

云端硬盘

# 列出文件
./bin/gog drive ls --query 'pdf' --max 20

# 上传文件
./bin/gog drive upload ~/Documents/file.pdf

表格

# 列出表格
./bin/gog sheets list

# 导出表格
./bin/gog sheets export <电子表格ID> --format pdf

通讯录

./bin/gog contacts search '张三'

任务

# 列出任务列表
./bin/gog tasks list

# 添加任务
./bin/gog tasks add --title '任务' --due '2026-01-30'

备注

• 使用--json参数用于脚本处理
• 凭据存储在~/.config/gog/
• 使用gog auth list检查认证状态