一个命令行，接管整个 Google 工作区：GWS — 开发者与 AI 代理的终极办公自动化利器

昆仑 AI

2026-04-14 0 7

你是否厌倦了在 Google Drive、Gmail、Calendar、Sheets、Docs、Chat 和 Admin 控制台之间反复切换？是否每次调用 Google API 都要写 OAuth 流程、处理 JSON 响应、维护 SDK 版本？gws（Google Workspace CLI） 就是为此而生——它不是一堆零散脚本的集合，而是一个用 Rust 编写的、真正「活」着的命令行工具：它不依赖静态命令列表，而是实时对接 Google 官方 Discovery Service，在运行时动态生成全部 API 命令。无论 Google 昨晚上线了哪个新接口，今天你就能用 gws drive.files.list 或 gws gmail.users.messages.send 直接调用，零配置、零等待、零过期。

核心功能

全平台统一入口：一套 CLI 覆盖 Drive、Gmail、Calendar、Sheets、Docs、Slides、Chat、Admin SDK、Groups、Contacts 等全部 Google Workspace 服务，告别多个 CLI 工具切换之苦
动态命令发现：不打包固定命令，而是启动时自动拉取 Google Discovery API 元数据，实时同步所有端点、参数、权限范围（scopes），API 更新即命令可用
结构化输出优先：默认输出标准 JSON，天然适配 shell 管道（| jq）、CI/CD 脚本、自动化工作流，也支持 CSV、YAML、表格等格式一键转换
开箱即用的 AI 代理技能：内置 40+ 预置「Agent Skills」——比如「总结收件箱未读邮件」「列出上周修改过的文档」「生成会议纪要并存入指定文件夹」，可直接调用或作为 RAG/Agent 框架的数据源
开发者友好体验：完整 OAuth2 授权流程内建（支持浏览器授权码 + 本地回调），自动缓存 token；支持 service account 模式，企业管理员可批量管理组织单位（OU）和用户策略
轻量 & 跨平台：单二进制发布（无 Node.js/Python 运行时依赖），原生支持 macOS、Linux、Windows（包括 ARM64），安装即用，体积仅数 MB

适合哪些人用

如果你是以下角色之一，gws 几乎立刻就能提升你的生产力：
✅ IT 管理员：批量创建用户、设置安全策略、审计日志导出、跨组织单位迁移文件，全部一条命令搞定；
✅ 开发者与 SRE：将 Google Workspace 集成进 CI/CD、监控告警、内部工具平台，无需再维护脆弱的 Python/JS SDK；
✅ 自动化爱好者：用 shell 脚本 + gws 实现「每天早 9 点自动归档 Gmail」、「检测 Sheets 新增行并触发 Chat 通知」；
✅ AI 应用构建者：把 gws 当作 RAG 的权威数据通道——让大模型直接「读取真实邮箱」「查询日历空闲时段」「写入 Docs 文档」，无需自己封装 API；
✅ 效率极客：拒绝 GUI 点击，用 gws docs.create --title "周报" --folder-id xxx 替代打开浏览器、新建文档、拖入文件夹三步操作。

快速上手

只需两步，30 秒完成安装与首次授权：

安装（任选其一）：
– macOS（Homebrew）：brew install googleworkspace/tap/gws
– Windows（Scoop）：scoop bucket add googleworkspace https://github.com/googleworkspace/scoop-bucket.git && scoop install gws
– 所有平台（手动下载）：前往 GitHub Releases 页面，选择对应系统架构的 gws_*.tar.gz 或 .zip 解压即可
首次使用：gws auth login → 浏览器弹出 Google 授权页 → 选择账号并同意所需权限 → 回到终端即完成认证
之后所有命令自动复用 token，支持多账号 profile 切换（gws --profile=admin auth login）