Google Workspace (gws CLI) 是由 OpenClaw 团队开发的命令行工具，旨在通过统一的终端接口高效管理 Google Workspace 生态中的全部服务。该工具封装了 Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin、Tasks、Meet、Slides、Forms、Contacts 等所有核心 Workspace 功能，使开发者、运维人员和自动化流程能够以脚本化方式与 Google 云服务交互。用户无需编写复杂 SDK 代码，只需掌握简单的命令结构即可完成文件操作、邮件处理、日程管理等日常任务。gws CLI 基于 Node.js 构建，支持标准 OAuth2 认证机制，并兼容服务账号和预获取令牌等多种身份验证方式，适用于从本地开发到生产环境部署的多种场景。其设计强调安全性和可观测性，所有请求均通过结构化 JSON 传输，响应数据可通过 jq 等工具灵活提取，极大提升了自动化集成的效率。
核心功能特点
- 统一管理全部 Google Workspace 服务（Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等）
- 基于命令行的极简操作模式，支持参数化调用与 JSON 输入输出
- 内置分页与流式处理机制，轻松获取大规模数据集
- 支持 OAuth2 用户认证、服务账号及预取令牌三种安全认证方式
- 提供 dry-run 预览功能，避免误操作导致的数据风险
- 响应数据为结构化 JSON，便于结合 jq 进行字段筛选与管道处理
适用场景
gws CLI 特别适合需要批量处理 Google Workspace 数据的自动化场景。例如，系统管理员可使用它快速检索公司域内所有用户的未读邮件，自动归档重要客户通信；IT 运维人员则能编写脚本定期清理临时文件、同步会议记录至知识库或生成周报摘要。对于 DevOps 工程师而言，该工具是 CI/CD 流水线中的理想组件——在部署完成后自动发送 Chat 通知，或在成功构建后更新任务列表状态。此外，数据分析师可利用 gws 抓取 Sheets 中的最新报表内容，结合外部数据库进行趋势分析。由于其完全基于命令行运行，gws CLI 也广泛适用于无图形界面的服务器环境，如 Kubernetes Pod、云函数或无头机器，配合 cron 或 Airflow 实现定时调度任务。无论是构建内部工具链还是扩展企业自动化能力，gws CLI 都提供了比传统 API 调用更简洁、更可控的操作体验。