5分钟配置：让AI智能体完全掌控Google Workspace - OpenClaw必备工具Google Workspace CLI

谷歌工程师刚刚低调发布了一个让AI智能体社区兴奋不已的工具。

它叫做 gws（Google Workspace CLI），是一个单一的命令行工具，让AI智能体能够直接访问Gmail、Google云端硬盘、日历、表格、文档、幻灯片、Chat、任务、Meet、表单、Keep、课堂、管理控制台，以及几乎所有现有的Google Workspace API。全部通过结构化的JSON输出实现。开箱即用，完全为智能体准备。

最引人注目的是：它附带了100多种智能体技能，并且在README中内置了对OpenClaw的原生支持。

让我们来分析一下为什么这很重要，以及如何立即开始使用它。

5分钟配置：让AI智能体完全掌控Google Workspace - OpenClaw必备工具Google Workspace CLI

什么是 gws，为什么你应该关注？

对于非技术爱好者来说，gws 是一个命令行工具，让AI智能体可以直接控制你的Google Workspace应用。可以把它想象成给你的AI智能体赋予超能力，让它能够管理你的电子邮件、日历、文件等等。

对于技术人员来说，gws 是一个用Rust构建的CLI，它将每个Google Workspace API封装成简洁、可组合的命令。但巧妙之处在于它的实际工作方式。大多数开发者工具都会遇到这样的问题：它们发布一个固定的命令列表，每当谷歌添加新功能时，必须有人手动更新工具、发布新版本，并希望每个人都升级。这是一个永无止境的维护循环。你见过的多数Google Workspace封装器在你安装时可能已经过时了。

gws以一种根本不同的方式解决了这个问题。它没有硬编码命令，而是直接与所谓的Google Discovery Service通信。可以把它想象成谷歌自己维护的、涵盖所有Workspace应用中每个操作的实时目录。每个API，每个方法，每个参数。谷歌自己维护这个目录，并且它始终是最新的。

当你运行gws时，它做的第一件事就是拉取这个实时目录，然后根据谷歌当前可用的内容动态构建其完整的命令结构。所以，如果谷歌今天下午2点发布一个新的表格功能，你的CLI在2:01分就已经支持了。无需更新。无需新版本。无需等待维护者跟进。这个工具根本不可能落后，因为它每次都从事实来源读取。这是一种值得更多工具采纳的设计理念。不要去维护他人API表面的副本。只需实时读取它并基于它构建。

那么，为什么这对智能体特别重要？因为每一个响应都以结构化的JSON格式返回。不是HTML。不是格式化文本。不是那种需要智能体费力解析的东西。干净、可预测、机器可读的数据，AI智能体可以立即理解并据此采取行动。这就是尚可工作的智能体和可靠工作的智能体之间的区别。

开始使用：最初的5分钟

如果你想立即尝试，以下是快速路径。只需确保你首先安装了gcloud CLI，如果没有，在macOS上只需 brew install --cask gcloud-cli。

# 1. 安装CLI
npm install -g @googleworkspace/cli

# 2. 设置认证（会引导你完成所有步骤）
gws auth setup

# 3. 登录你的Google Workspace账户
gws auth login

就这样。三个命令，你就可以从终端与Google Workspace通信了。

这些是你可能在 gws auth setup 后看到的界面：

很酷的一点是，你可以从一个账户开始，之后添加多个账户（工作、个人等），你的智能体可以根据上下文使用它们。

接下来是GCP项目设置。你可以创建一个新项目或使用现有项目。所有这些都可以通过CLI本身完成。是不是很酷？

然后你启用所需的API。同样，全部通过CLI完成。天哪，我爱上它了！

有些人可能会遇到这个手动的OAuth客户端设置。别担心，这很简单。

完成这一步后，你的设置就全部完成了。现在你可以用 gws auth login 登录，并为你的智能体提供合适的工作权限。

如果你为你的智能体准备了单独的邮箱，大胆地给它完全访问权限吧！

如果你是用个人/工作邮箱登录，开始时给它有限访问权限。你随时可以稍后更改。

就这样！一切就绪。

现在让我们看看如何将它接入你的智能体设置。

开箱即用的100多种智能体技能

这是让OpenClaw和Claude Code社区真正感兴趣的地方。

该仓库附带了超过100个SKILL.md文件，分为四个类别。如果你不熟悉SKILL.md格式，它是为AI智能体提供结构化、可组合能力的新兴标准。可以把技能想象成应用程序，但用于智能体知识和工具访问。

以下是技能的組織方式：

服务技能（25+）

每个Google Workspace API对应一个技能。这些是你的构建模块：

gws-drive - 用于管理文件、文件夹和共享云端硬盘
gws-gmail - 用于发送、阅读和管理电子邮件
gws-calendar - 用于管理日历和事件
gws-sheets - 用于读写电子表格
gws-docs - 用于读写Google文档
gws-slides - 用于演示文稿
gws-tasks - 用于任务列表
gws-chat - 用于Google Chat空间和消息
gws-people - 用于联系人和个人资料
gws-admin - 用于管理用户、组和设备
gws-classroom - 用于课堂、花名册和课程作业
gws-forms - 用于Google表单
gws-keep - 用于Google Keep笔记
gws-meet - 用于会议管理
gws-vault - 用于电子取证
gws-apps-script - 用于管理Apps Script项目

还有更多技能涵盖了Cloud Identity、Alert Center、Group Settings、Licensing、Reseller，甚至包括用于安全过滤的Model Armor。

角色技能（10个预构建的智能体角色）

这是真正脱颖而出的部分。谷歌创建了10个即用型角色捆绑包，定义了完整的智能体角色：

行政助理 - 管理日程、收件箱和通信
项目经理 - 协调项目、跟踪任务、安排会议
人力资源协调员 - 处理入职、公告、员工沟通
销售运营 - 管理销售流程、跟踪交易、安排电话
IT管理员 - 管理用户、监控安全、配置Workspace
内容创作者 - 创建、组织和分发内容
客户支持 - 管理工单、响应问题、处理升级
活动协调员 - 规划活动、管理邀请、处理后勤
团队负责人 - 主持站会、协调任务、管理团队沟通
研究员 - 组织研究、管理参考文献、处理协作

每个角色都捆绑了针对该特定角色的正确服务技能、辅助命令和工作流程模式。你无需弄清楚你的智能体需要Gmail + 日历 + 云端硬盘 + 表格技能的哪种组合。只需给它这个角色，它就知道该做什么。

辅助技能

这些是最常见操作的快捷命令。比如用于快速上传文件的 gws-drive-upload，用于发送电子邮件的 gws-gmail-send，以及用于在提示词到达智能体之前清理它们的 gws-modelarmor-sanitize-prompt。

配方技能（50个精选工作流程）

包含实际命令的多步骤任务序列。例如审计外部共享的云端硬盘文件、根据表格数据发送个性化电子邮件，以及其他常见的生产力自动化。这些是"复制粘贴即可用"的工作流程，可以节省数小时的提示工程时间。

如何与OpenClaw一起使用

谷歌实际上在README中包含了OpenClaw的设置说明。这不是社区黑客或变通方法。这是内置的、一流的支持。

以下是开始使用的方法：

选项1：符号链接所有技能（推荐用于开发）

# 克隆仓库
git clone https://github.com/googleworkspace/cli.git
cd cli

# 将所有技能符号链接到你的OpenClaw技能目录
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

这样可以与仓库保持同步。当谷歌更新技能时，你会自动获得更新。

选项2：复制特定技能

# 只获取你需要的
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

选项3：使用技能CLI

# 一次安装所有技能
npx skills add https://github.com/googleworkspace/cli

# 或者挑选单个技能
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

gws-shared 技能在这里特别聪明。它包含一个安装块，如果 gws 不在你的PATH中，它会通过npm自动安装CLI。这样你的OpenClaw智能体可以自举。它会检查工具，如果需要就安装，然后开始工作。无需手动设置。

如何与Claude Code一起使用

如果你是Claude Code用户（老实说，这是我最近大部分时间都在用的工具），有几种方法可以将gws引入你的工作流程。

方法1：直接CLI访问

Claude Code可以执行shell命令。一旦你安装并认证了gws，Claude Code可以直接调用它：

# Claude Code可以运行这个来查看你的日历
gws calendar events list --params '{"calendarId": "primary", "maxResults": 10}'

# 或者搜索你的Gmail
gws gmail users messages list --params '{"userId": "me", "q": "is:unread"}'

# 或者创建一个新文档
gws docs documents create --json '{"title": "Meeting Notes - March 2026"}'

结构化的JSON输出意味着Claude Code可以解析结果，对其进行推理，并在没有任何自定义工具的情况下采取后续行动。

方法2：MCP服务器

这是更强大的方法。gws包含一个内置的MCP服务器，将Workspace API作为结构化工具暴露出来：

# 启动MCP服务器，指定服务
gws mcp -s drive,gmail,calendar

你可以在你的MCP客户端设置中配置它：

{
  "mcpServers": {
    "gws": {
      "command": "gws",
      "args": ["mcp", "-s", "drive,gmail,calendar"]
    }
  }
}

这适用于Claude桌面版、VS Code、Gemini CLI以及任何兼容MCP的客户端。每个服务大约增加10到80个工具，所以保持列表专注于你实际需要的服务，以保持在工具限制内。

方法3：向项目添加技能

如果你正在处理一个Claude Code项目，并希望它理解Google Workspace操作，你可以将相关的SKILL.md文件添加到你的项目上下文中。这为Claude Code提供了构建正确gws命令以完成你交给它的任何任务的过程性知识。

Model Armor：内置的智能体安全性

这里有一个没有得到足够关注的地方。该仓库包含了与Google Cloud Model Armor的集成，用于响应净化。

这在实践中意味着什么？当你的智能体从Gmail或云端硬盘读取数据时，这些数据可能包含提示注入攻击。有人可能精心制作一封专门用来操纵你智能体行为的电子邮件。Model Armor在API响应到达你的智能体之前扫描它们，并过滤掉潜在的恶意内容。

gws gmail users messages get --params '...' \
  --sanitize "projects/P/locations/L/templates/T"

你可以在警告模式（标记可疑内容但仍返回）或阻止模式（完全剥离）下运行它。当智能体在它们从未见过的电子邮件和文档内容上自主运行时，这一点尤其重要。

顺便提一下，Cisco的AI安全团队发现，ClawHub上31,000多个技能中有26%存在漏洞，SecurityScorecard报告称63%暴露的OpenClaw实例配置错误。智能体安全不是一个理论问题。它正在发生。在数据管道中内置安全过滤是谷歌的一个明智之举。

为什么这个工具很重要

这里展示了你的智能体可以用gws做的所有酷事情：

Gmail：搜索、阅读、发送和组织电子邮件

# 搜索收件箱中来自特定发件人的未读邮件
gws gmail users messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# 阅读特定电子邮件
gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}'

# 发送电子邮件（辅助命令处理所有编码）
gws gmail +send --to alice@company.com --subject 'Q2 Report Ready' \
  --body 'Hey Alice, the Q2 report is ready for review.'

# 整理未读收件箱（智能体友好的摘要）
gws gmail +triage --max 5 --query 'from:boss'

日历：查看你的日程、创建和更新事件

# 查看今天日历上的安排
gws calendar +agenda

# 创建带有与会者的会议
gws calendar +insert --summary 'Weekly Standup' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# 创建包含所有详细信息的重复事件
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Weekly Standup",
    "start": {"dateTime": "2026-03-10T09:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T09:30:00", "timeZone": "America/Vancouver"},
    "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO"],
    "attendees": [{"email": "team@company.com"}]
  }'

# 重新安排事件并通知与会者
gws calendar events patch \
  --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}' \
  --json '{
    "start": {"dateTime": "2026-03-10T14:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T15:00:00", "timeZone": "America/Vancouver"}
  }'

云端硬盘：上传、下载、组织和共享文件

# 列出最近的10个文件
gws drive files list --params '{"pageSize": 10}'

# 上传文件到特定文件夹
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# 创建新的项目文件夹
gws drive files create \
  --json '{"name": "Q2 Project", "mimeType": "application/vnd.google-apps.folder"}'

# 下载文件
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# 将Google文档导出为PDF
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# 与同事共享文件夹
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

表格：读取、写入和创建电子表格

# 读取特定范围的数据
gws sheets +read --spreadsheet-id SHEET_ID --range 'Contacts!A2:C'

# 追加一行新数据
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sheet1' \
  --values '["2026-03-05", "Marketing", "Ad spend", "1500"]'

# 创建全新的电子表格
gws drive files create \
  --json '{"name": "Expense Tracker 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

文档：创建和写入文档

# 创建新文档
gws docs documents create --json '{"title": "Meeting Notes - March 2026"}'

# 向现有文档写入内容
gws docs +write --document-id DOC_ID \
  --text '## Project: Q2 Launch\n\n### Objective\nLaunch the new feature by end of Q2.'

Chat、Meet、表单等

# 在Google Chat中发送团队通知
gws chat +send --space spaces/TEAM_SPACE \
  --text 'Important: Please check your email for the updated policy.'

# 创建Google Meet会议室
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# 创建反馈表单
gws forms forms create \
  --json '{"info": {"title": "Event Feedback", "documentTitle": "Event Feedback Form"}}'

# 创建演示文稿
gws slides presentations create --json '{"title": "Quarterly Review Q2"}'

注意这个模式。每个操作都是一行命令。而 + 辅助命令（如 +send、+upload、+agenda、+triage、+read、+append、+write）处理了通常需要10行样板代码的所有繁琐编码和格式化。你的智能体不需要了解RFC 2822电子邮件格式或base64编码。它只需说出它想做什么，gws处理剩下的事情。