Google Workspace 的各个服务 API 一直是割裂的：调邮箱、云盘、日历、表格要分别对接接口、单独配置授权。在 AI Agent 满地跑的 2026 年，让 Agent 操作 Gmail、Calendar、Drive 反而没有顺手工具。Google Workspace CLI 想解决的就是这件事——它把全线产品 API 封装成统一命令行，所有返回数据输出标准 JSON，并内置 100 多个适配 AI 智能体的 Agent Skills。这个项目在 GitHub 拿下近 3 万 Star，但其核心开发者 Justin Poehnelt 却因为该项目被谷歌解雇。本文先讲它做了什么、怎么用，再简述那场争议。

Google Workspace CLI 是什么

一句话定义：把 Google Workspace API 变成一个既适合人类、也适合 AI Agent 调用的统一接口。

• 对人类：不再需要根据 REST 文档手写 curl 请求，每个资源都提供 --help，支持 --dry-run 预览请求，自动处理分页
• 对 AI 智能体：所有返回结果都是结构化 JSON，结合内置 Agent Skills，LLM 在无需编写额外工具的情况下就能直接管理 Workspace

项目地址 github.com/googleworkspace/cli，截至目前 Star 量近 3 万。

核心功能

统一封装全线 Workspace 产品

Gmail、Drive、Calendar、Sheets、Chat、Admin 全线产品的 API 都被封装成同构的命令行子命令。一条命令完成一类操作，省去反复查文档的麻烦。

两阶段解析架构

CLI 采用 two-phase parsing 策略，兼顾性能和动态性：

1. 读取 argv，识别要调用的服务（例如 drive）
2. 获取该服务的 Discovery Document（API 发现文档），缓存 24 小时
3. 根据文档中定义的 resources 和 methods，动态构建 clap::Command 命令树
4. 再次解析剩余命令行参数
5. 完成身份认证、构建 HTTP 请求并执行

所有输出（成功结果、错误信息、下载元数据）都以结构化 JSON 返回，方便程序和 LLM 解析。

内置 100+ Agent Skills

这是面向 AI Agent 最关键的能力：

• 每个支持的 API 都对应一个 Skill（以 SKILL.md 文件形式提供）
• 还包含一些用于常见工作流程的高层辅助技能
• 提供 50 个精选使用示例，覆盖 Gmail、Drive、Docs、Calendar、Sheets 等应用

完整 Agent Skills 列表，每个 API 对应一个 SKILL.md，组合后能驱动 LLM 完成跨应用任务。

对人类友好的细节

• --help 帮助覆盖每个资源
• --dry-run 预览将要发出的请求，便于调试
• 自动分页处理，无需手动拼接 pageToken
• 统一的认证流程，支持 OAuth 与 Service Account

怎么用

安装与认证

# 通过 Homebrew 安装（macOS）
brew install googleworkspace/tap/cli

# 或从 GitHub Releases 下载预编译二进制
# https://github.com/googleworkspace/cli/releases

# 首次运行会引导 OAuth 授权
gws-cli gmail messages list --query "is:unread"

配合 AI Agent 使用

把项目里的 SKILL.md 文件挂载到你的 Agent 工具目录，Agent 就能自动调用对应技能。例如让 Codex / Claude Code 帮你"找上周所有带附件的未读邮件并下载到本地"，Agent 会自动选择 gmail.messages.list → gmail.messages.get → gmail.attachments.get 这一串命令链。

典型工作流示例

那场"被解雇"的争议

这个工具本身做对了几乎所有事——上线即冲上 Hacker News 第一，引来谷歌内部总监和高管排着队请教。但故事没按"内部创新被公司放大"的剧本走：

• 核心贡献者 Justin Poehnelt（GitHub 上排名第一，24 次 commits）透露，自己因为这个项目被解雇
• 直接导火索是法务反复追问"为什么项目的 GitHub 仓库里出现了谷歌 Logo 和品牌配色"
• 更具讽刺意味的时间线：他被解雇前两天，Google Cloud Next 刚官宣要推出官方版 Workspace CLI，需求和实现思路与他业余做的工具高度重合
• 为他打抱不平的"OpenClaw 之父"公开喊话："谷歌把那个做出了 Google Workspace CLI 的人开了，原因就是他做出了这个项目。幸好，谷歌开不了我。"并邀请 Poehnelt 加入 Codex 团队

💡 提示：对使用者来说，那场争议不影响工具本身的价值。但需要注意——谷歌已发布官方版同款工具 GWS，未来该开源项目能否持续获得内部资源支持存在不确定性，企业级使用前建议评估两条路线的稳定性。

应用场景

• AI Agent 自动化办公：让 Codex / Claude Code 这类 Agent 直接管你的 Gmail、Calendar、Drive
• 批量数据迁移与备份：跨账户同步邮件、归档 Drive 文件
• 运维与合规审计：批量查询 Admin 目录、导出合规报告
• 个人开发者效率工具：把零散的 Workspace 操作脚本化，告别手写 curl

项目信息

• GitHub：https://github.com/googleworkspace/cli
• Star 数：近 3 万（截至 2026 年 6 月）
• 语言：Rust（基于 clap::Command）
• 许可证：见仓库 LICENSE 文件
• 官方替代品：Google Cloud 推出的官方版 GWS（功能重合度高）