[JS/TS] Google 开源 gws 命令行工具，整合 Workspace 全系 API 并原生支持 AI Agent

自 2026 年以来，OpenClaw 持续火爆，甚至催生了“上门安装”业务。很多朋友在部署成功后，第一个想法就是让它帮忙处理邮件、整理日历、同步网盘等日常事务。

然而现实很快给我们泼了冷水——多数平台并未对外提供 API，想接入几乎无门。

就在近日，Google 在 GitHub 上悄无声息地开源了一个命令行工具：gws。它将 Google Workspace 的全套服务 API 打包整合，一经开源，GitHub Star 数便迅速飙升了超过 14000 个。

有了它，你可以在终端里直接操作 Drive、Gmail、Calendar、Sheets、Docs 等 Google 的全套办公工具。再也不需要反复切换浏览器标签页，也不必翻阅 API 文档手动拼接 curl 命令，繁琐的分页处理和 OAuth 认证都已被内置处理。

安装只需一条 npm 命令：

npm install -g @googleworkspace/cli

与传统的、命令列表固定的 CLI 工具不同，gws 采用了全新的动态构建思路。它在运行时直接读取 Google 官方的接口描述文件，并据此动态生成命令结构。这意味着，如果 Google 在后台悄悄上线了新接口，你的 gws 工具无需任何更新即可自动支持。

这一设计对 AI Agent 而言尤为重要。所有响应结果均为结构化的 JSON 数据，Agent 可以直接处理，省去了大量的文本解析工作。

可以说，gws 几乎是为 AI Agent 量身打造的。它原生支持 MCP（Model Context Protocol），可以轻松集成到任意 Agent 中。通过一行命令启动 MCP 服务器，你就能将 Workspace 的 API 直接暴露为 Agent 可用的工具接口：

gws mcp -s drive,gmail,calendar

接下来，只需在 Claude Desktop、Cursor 等支持 MCP 的客户端中完成配置，就能让 AI 助手帮你查询日历、上传文件或发送邮件了。

此外，项目内置了超过 100 个预置的 Agent Skills，覆盖了 Gmail、Drive、Docs、Calendar、Sheets 等服务的常见工作流，真正做到开箱即用：

npx skills add https://github.com/googleworkspace/cli

如果你已经安装了 OpenClaw，还可以直接将 Skills 软链接到 OpenClaw 的目录下。这样，当仓库更新时，你的 Skills 也会自动同步：

ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

更便利的是，你甚至不需要提前手动安装 gws。gws-shared 这个 Skill 内置了自动安装逻辑，当 OpenClaw 检测到环境变量中没有 gws 时，它会自动通过 npm 完成安装。

不过，使用前需要完成认证配置，这一步略有门槛。你需要先拥有一个 Google Cloud 项目来生成 OAuth 凭据。可以通过执行引导命令 gws auth setup 并跟随提示完成，但前提是必须提前安装好 gcloud CLI，否则会遇到如下错误：

需要提醒的是，该项目目前仍处于测试预览阶段，其 README 明确提示未来会有重大更新。建议先用于个人项目或体验尝鲜，若计划用于生产环境，建议先观望其版本的稳定性。

总结与展望

以往，对接一项 Google 服务往往意味着需要花费半天时间查阅文档、配置 OAuth 和处理分页逻辑。如今，gws 将这些复杂性全部封装，开箱即用，相当于随时为你的 AI Agent 装备了一套可直接调用的“手脚”。

对于日常依赖 Google 全家桶的用户而言，效率的提升是实打实的。邮件、日历、云盘、表格……这些以往需要分别处理的事务，现在一个工具就能全部打通。

从更广阔的视角看，Google 选择将自家全系产品的底层接口如此开放地封装成一个命令行工具，在整个开源生态中并不多见。如此体量的公司，主动降低开发者的接入门槛，这本身就值得一个 Star。

当然，我们也期待未来有更多平台能够跟进。开放的入口越多，AI Agent 能够流畅运行的场景就越丰富，AI 真正替代我们处理工作的那一天，或许就更近了一步。

项目地址：https://github.com/googleworkspace/cli

对于这类能提升开发者效率的 开源 工具，你怎么看？欢迎在 云栈社区 分享你的使用体验或见解。