FollowAgents AI AGENTS 目录
首页 / 全部 Agents / gws Google Workspace 命令行
效率与协作 google-workspacegoogle-drivegmailgoogle-calendaroauth2discovery-apirust-cligemini-cli-extension

gws Google Workspace 命令行

用一个动态生成的命令行界面调用 Google Workspace API，并为自动化与智能体提供结构化 JSON 输出。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
googleworkspace/cli
Star 数
★ 32k
最近更新
3 天前
License
Apache-2.0
主语言
Rust
FA 评分
54/100 · 缺口较多

30 秒速览

运行形态
命令行工具Agent 插件 / 技能
可在哪里用
平台专用
费用
免费，无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Google Workspace 账号Google Cloud 项目Node.js 18+（用于 npm 安装）Shell / 命令行网络访问本地文件系统
典型场景
需要从终端列出最近 Drive 文件、上传报告或读取 Google Workspace API 数据的运维人员。
不适合
  • 不使用 Google Workspace 或没有 Google Cloud 项目的团队
  • 需要稳定 API、不愿承受 v1.0 前破坏性变更的用户
  • 无法安装 gcloud 又不愿手动配置 OAuth 客户端的用户
源码审查
54/100 · 缺口较多 1 项安全控制未见

这个 Agent 能做什么，适合哪些场景？

gws 是一个面向人类和 AI 智能体的 Google Workspace 命令行工具，覆盖 Drive、Gmail、Calendar、Sheets、Docs、Chat 及更多 Workspace API。它在运行时读取 Google Discovery Service，为目标服务动态生成命令、资源和方法，而非维护静态命令清单。命令执行后输出结构化 JSON，分页模式可输出 NDJSON，适合脚本和自动化流程消费。项目还提供 100 多个 SKILL.md Agent Skills、常用工作流配方，以及 Gemini CLI 扩展安装路径。它是本地 CLI，不是托管服务；调用 Workspace 数据需要 Google Cloud OAuth 或其他已配置的凭据。该项目仍在积极开发中，并明确提示 v1.0 前可能存在破坏性变更。

用户先通过 gws auth setup、gws auth login、GOOGLE_WORKSPACE_CLI_TOKEN 或 GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE 配置身份验证。执行例如 gws drive files list --params '{"pageSize": 5}' 时，gws 先从 argv[1] 识别 drive，获取并缓存该服务的 Discovery Document，然后据此构建 clap::Command 命令树并重新解析参数。随后它完成认证、构造 HTTP 请求、调用相应 Google API，并把成功结果、错误和下载元数据作为 JSON 输出；--page-all 会逐页输出 NDJSON。除 Discovery 生成的方法外，gws 还提供带 + 前缀的助手命令，例如 gmail +send、drive +upload、calendar +agenda、workflow +standup-report 和 events +subscribe。它支持通过 --sanitize 配合 Google Cloud Model Armor 模板扫描 API 响应中的提示注入风险。

  1. 需要从终端列出最近 Drive 文件、上传报告或读取 Google Workspace API 数据的运维人员。
  2. 需要以 JSON 调用 Gmail、Calendar、Sheets、Docs 或 Chat 的自动化脚本作者。
  3. 希望让已安装 Gemini CLI 扩展的智能体使用已认证 gws 命令和仓库内技能的团队。
  4. 需要通过 calendar +agenda、workflow +meeting-prep 或 +weekly-digest 汇总个人工作安排的 Workspace 用户。
  5. 需要在 CI 或无头服务器上导出凭据并以 GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE 调用 Workspace API 的工程团队。
  6. 需要用 Model Armor 模板在智能体消费 Gmail 或其他 API 响应前进行提示注入检查的开发者。

如何安装或部署这个 Agent？

前提是拥有可访问 Google Workspace 的 Google 账号和 Google Cloud 项目。推荐从 GitHub Releases 下载与操作系统和架构匹配的预构建二进制，将 gws 放入 PATH；也可执行 npm install -g @googleworkspace/cli（需要 Node.js 18+）、cargo install --git https://github.com/googleworkspace/cli --locked、nix run github:googleworkspace/cli，或在 macOS/Linux 上执行 brew install googleworkspace-cli。首次本地认证可运行 gws auth setup，然后运行 gws auth login；若没有 gcloud，可在 Google Cloud Console 创建 Desktop app OAuth 客户端，将客户端 JSON 保存为 ~/.config/gws/client_secret.json，再运行 gws auth login。

如何使用这个 Agent？

完成认证后，可运行：gws drive files list --params '{"pageSize": 5}'。创建表格可运行：gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'。查看命令的请求与响应模式可运行 gws schema drive.files.list；自动翻页并逐页输出 NDJSON 可使用 gws drive files list --params '{"pageSize": 100}' --page-all。无头环境可先在有浏览器的机器上执行 gws auth export --unmasked > credentials.json，再设置 export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json。

这个 Agent 有哪些优点和局限？

优点
  • 运行时使用 Google Discovery Service 构建命令面，Google Workspace 新增 API 端点或方法时可被自动纳入。
  • 所有成功、错误和下载元数据均为结构化 JSON，并支持 --page-all 的 NDJSON，便于脚本和智能体处理。
  • 同时提供 Discovery 方法与明确标识的 + 助手命令，覆盖发邮件、上传文件、日程摘要和跨服务工作流。
  • 认证覆盖交互式 OAuth、凭据文件、服务账号和预先获取的访问令牌，适用于桌面、CI 和服务器场景。
  • 仓库提供 100 多个 Agent Skills，并有 Gemini CLI 扩展安装方式。
局限
  • 核心用途依赖 Google Workspace、Google Cloud 项目和 Google OAuth 或服务账号凭据，无法作为通用 SaaS CLI 使用。
  • 未验证且处于测试模式的 OAuth 应用约受约 25 个 scope 限制；recommended 预设的 85+ scopes 可能登录失败。
  • gws auth setup 依赖 gcloud；没有 gcloud 时需要手动在 Google Cloud Console 配置 Desktop app OAuth 客户端和测试用户。
  • 项目仍在积极开发，文档明确提示 v1.0 前预计会有破坏性变更。
  • 运行时需要获取 Discovery Document；获取失败会以退出码 4 终止命令。

这个 Agent 与同类方案有什么区别？

相较于直接按 REST 文档编写 curl 调用，gws 提供由 Discovery Service 动态生成的命令、内置帮助、--dry-run、自动分页和结构化 JSON 输出。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
gws Google Workspace 命令行 当前 54 · 缺口较多 命令行工具免费 ★ 32k 3 天前 Rust —
ENZO 自托管 AI 工作台 68 · 存在缺口 自托管服务免费 + 模型费 ★ 117 今天 TypeScript —
Zapier MCP 插件 41 · 缺口较多 Agent 插件 / 技能 ★ 452 14 天前 — Codex · Claude Code
Iva 个人助理 85 · 表现良好 聊天机器人免费 + 模型费 ★ 285 3 天前 TypeScript ChatGPT · Codex

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
缺口较多
54/ 100 五分制 2.7 / 5
信任安全 11/29
可靠稳定 9/14
适用触发 12/18
规范维护 10/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

证据显示：README 描述了 OAuth 流程、凭据加密（AES-256-GCM）、作用域选择、--dry-run 预览、环境变量优先级、安全报告渠道（SECURITY.md）和依赖审计工作流（audit.yml）。扣分：未提供代码级验证，未明确最小权限原则，用户确认机制仅体现在 OAuth 同意和 --dry-run，数据流透明度有限，未提及回滚机制，发布者身份未验证。

可靠稳定9 / 14 · 3.2/5

证据显示：README 提供退出码、故障排除、结构化 JSON 输出，架构描述清晰。扣分：未提供测试结果或执行验证，依赖可用性仅通过 CI 工作流暗示，失败消息仅部分示例。

适用触发12 / 18 · 3.3/5

证据显示：README 面向人类和 AI 代理，提供多种安装方式、环境变量、使用场景（如 CI、无头）。扣分：能力边界未明确列出，触发精度依赖动态发现，环境适配未覆盖所有平台。

规范维护10 / 18 · 2.8/5

证据显示：README 结构清晰，提供安装说明、示例、故障排除、许可证（Apache-2.0）、版本号（0.22.5）。扣分：命名稳定性未保证（预发布），变更日志未提供，维护责任未明确（未验证发布者）。

有效结果9 / 13 · 3.5/5

证据显示：README 强调结构化 JSON 输出、自动分页、动态命令表面，提供多种安装方式。扣分：未提供性能基准或成本分析，边际价值基于断言。

证据核验3 / 8 · 1.9/5

证据显示：README 声明动态构建、AI 技能等，但未提供可追溯的测试或独立验证。扣分：声明与证据分离不明确，交叉来源有限。

风险与缓解建议
  • 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
  • 发布者身份未验证，需谨慎对待供应链风险。
  • 项目处于预发布阶段，存在破坏性变更风险。
  • 动态命令表面可能引入意外行为，需在隔离环境中测试。
  • 凭据处理虽加密，但需确保密钥管理安全。
证据充分度：低 评估于 2026年8月9日 审查版本 a3768d0e82ad 评估后仓库已有新提交，评分可能未覆盖最新改动
评估证据 README.mdCargo.tomlLICENSESECURITY.mdpackage.jsonworkflows/audit.ymlworkflows/automation.yml
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. v0.22.5
    发布说明摘录
    Installation Download the archive for your OS and architecture from the assets below. Linux / macOS Replace <target> with your platform (e.g., aarch64-apple-darwin or x86_64-unknown-linux-gnu). ```bash 1. Download the archive and its checksum curl -sLO https://github.com/googleworkspace/cli/releases/download/v0.22.5/google-workspace-cli-<target>.tar.gz curl -sLO https://github.com/googleworkspace/cli/releases/download/v0.22.5/google-workspace-cli-<target>.tar.gz.sha256 2. Verify the checksum shasum -a 256 -c google-workspace-cli-<target>.tar.gz.sha256 …
    在 GitHub 查看 ↗
  2. v0.22.4
    发布说明摘录
    What's Changed * chore: remove cargo-dist, use native fetch for npm installer by @jpoehnelt in https://github.com/googleworkspace/cli/pull/646 * chore: release versions by @googleworkspace-bot in https://github.com/googleworkspace/cli/pull/647 Full Changelog: https://github.com/googleworkspace/cli/compare/v0.22.3...v0.22.4
    在 GitHub 查看 ↗
  3. v0.22.3 0.22.3
    发布说明摘录
    Release Notes Patch Changes - 674d53a: Fix Lint Skills CI job by installing uv via astral-sh/setup-uv before running uvx - c7c42f6: fix: register script service and resolve test path validation errors - 80bd150: feat(auth): use strict OS keychain integration on macOS and Windows Closes #623. The CLI no longer writes a fallback .encryption_key text file on macOS and Windows when securely storing credentials. Instead, it strictly uses the native OS keychain (Keychain Access on macOS, Credential Manager on Windows). If an old .encryption_key file is found during a successf …
    在 GitHub 查看 ↗

常见问题

它是 Google 官方支持的产品吗？
不是。项目明确声明它不是官方支持的 Google 产品。
调用 API 需要哪些权限和凭据？
需要 Google Cloud 项目和可访问 Google Workspace 的 Google 账号。可使用交互式 OAuth、凭据文件、服务账号或 GOOGLE_WORKSPACE_CLI_TOKEN；OAuth scope 应按实际使用的服务选择。
能否在 CI 或无头服务器上使用？
可以。先在有浏览器的设备完成交互式认证并导出凭据，再在目标环境设置 GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE；也可指向服务账号密钥文件。
失败时如何让脚本判断原因？
退出码 1 表示 API 错误，2 表示认证错误，3 表示参数验证错误，4 表示 Discovery 错误，5 表示内部错误。
在 GitHub 查看 ↗ 安装 ↓

相关 Agents

效率与协作

ENZO 自托管 AI 工作台

用自己的模型密钥运行聊天、代理工具和项目编码工作流。
效率与协作

Zapier MCP 插件

让任何兼容 MCP 的 AI 客户端通过 Zapier 托管服务器，以自然语言操作 9,000+ 应用：发消息、取数据、触发工作流。
效率与协作

Iva 个人助理

在 Telegram 中整理消息、长期记忆并执行个人与办公任务。
效率与协作

OpenInstinct

能通过 iMessage 操作浏览器、代办事务并安全调用个人凭据的自托管助手。