谷歌开源 Google Workspace CLI：专为 AI Agent 设计的命令行工具

随着类似 OpenClaw 的 AI 智能体加速普及，一个显著的趋势正在发生：用户主动打开特定软件的频率在降低，转而更多地通过自然语言向 AI 下达指令。

过去，处理邮件需要打开邮箱客户端，手动点击、逐封回复。未来，你或许只需在聊天窗口中对 AI 说一句“处理一下今天重要的邮件”，它便能代为完成。

这引发了一个连锁思考：未来的软件，或许将不再仅仅为人设计，更需要为 AI 智能体设计。

然而，要让 AI 帮你操作 Gmail、Drive、日历等服务，首先需要为其提供标准化的接入方式。自行调用 API 过于繁琐，而各服务的 SDK 又互不统一。

正是在这个节点上，Google 官方出手了。

项目简介：统一的 Workspace 命令行接口

谷歌近日开源了 Google Workspace CLI（命令行工具 gws）。 它既服务于开发者，更是专为 AI Agent 场景打造。

该工具的核心价值在于，它将 Gmail、Drive、Calendar、Sheets、Docs 等 Google Workspace 全家桶服务的 API 进行了统一封装。 用户或 AI 只需发送简单的命令，gws 便会代为调用底层 API，并返回结构化的结果。

• GitHub 地址：https://github.com/googleworkspace/cli

gws 覆盖了主要的 Google Workspace 服务，包括 Drive、Gmail、Calendar、Sheets、Docs、Chat 等。其功能与官方 API 能力同步。以下是一些具体示例：

“`bash

列出 Drive 中最近的 10 个文件

gws drive files list –params ‘{“pageSize”: 10}’

创建一个名为 “Q1 Budget” 的 Google 表格

gws sheets spreadsheets create –json ‘{“properties”:{“title”:”Q1 Budget”}}’

在 Google Chat 的指定空间发送消息（–dry-run 为试运行模式）

gws chat spaces.messages.create
–params ‘{“parent”:”spaces/xyz”}’
–json ‘{“text”:”Deploy complete.”}’
–dry-run

查看某个 API（如 drive.files.list）的参数结构，用于调试

gws schema drive.files.list
“`

该项目一个巧妙的设计是不内置固定的命令集。每次运行时，它都会从 Google 官方实时拉取最新的 API 定义，动态构建命令。这意味着一旦 Google 为任何服务新增了功能，用户即可通过 gws 立即使用，无需等待 CLI 工具本身更新。

为 AI Agent 量身定做

命令行界面（CLI）的复兴，恰恰契合了 AI Agent 的交互需求。它将复杂的系统交互简化为纯粹的结构化文本流，使得 AI Agent 能够以其原生的 Token 预测和处理方式，直接、精确地驱动任务执行，彻底消除了图形界面（GUI）带来的视觉解析成本与交互不确定性。

Google Workspace CLI 从以下几个方面为 AI Agent 进行了深度优化：

1. 输出完全结构化

大型语言模型（LLM）处理非结构化文本效率较低。gws 的设计哲学是 “一切皆 JSON” 。无论是响应主体、元数据还是错误信息，全部以结构化 JSON 格式返回。AI Agent 无需费力解析面向人类读者的自然语言输出，可以直接读取并处理 JSON 数据。

2. 内置丰富的 Agent Skills

gws 自带超过 100 个预定义的 “Agent Skills”。其中一些 Skill 与单个 API 方法一一对应，另一些则封装了更复杂的业务流程，例如 Gmail 邮件的批量处理、Drive 文档的智能整理、Sheets 数据的批处理等。LLM 无需从零开始拼接 API 调用链，可以直接调用这些高阶技能完成任务。

快速开始

你可以通过以下步骤快速体验 gws：

“`bash

1. 安装

npm install -g @googleworkspace/cli

2. 认证

gws auth setup
gws auth login

3. 试运行：列出 Drive 前5个文件

gws drive files list –params ‘{“pageSize”:5}’

4. 查询 API 结构

gws schema drive.files.list
“`

此外，gws 能够与 OpenClaw、Gemini CLI 等 AI 智能体平台直接集成：

“`bash

为 OpenClaw 安装 Skills

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

为 Gemini CLI 安装扩展

gemini extensions install https://github.com/googleworkspace/cli
“`

安装完成后，即可让你使用的 AI 助理直接操作你的 Google Workspace 数据。

意义与趋势

对于正在开发能够操作 Gmail、Drive、Docs 等产品的团队而言，这个 CLI 是一个现成的 Workspace 能力网关，大幅降低了集成复杂度。

而其更大的意义在于，它代表了一个清晰的趋势：头部科技公司开始主动拥抱 Agent 时代，将自家核心产品进行“Agent-ready”化改造。 未来，每个 SaaS 服务都需要思考一个问题：如果用户主要通过 AI Agent 与我的产品交互，产品应该以何种形态存在？

Google Workspace CLI，为我们提供了一个值得参考的答案。

关注“鲸栖”小程序，掌握最新AI资讯