谷歌發布官方 CLI，可操作所有谷歌文檔

今天上午的時候，Google Workspace CLI 上線到了 GitHub，掛在 Google Workspace 的官方組織名下

GitHub：https://github.com/googleworkspace/cli

我開始寫這篇文章的時候，這個項目是 2700 個 Star；
當我發出去的時候，重新截了個圖，已經有 3500 個 Star 了

草...剛發完預覽，又變成 3700 個 Star..

快速增長的 Star

這個項目，最早由 Google Cloud AI 的 Director Addy Osmani 親自在推特上宣布

https://x.com/addyosmani/status/2029372736267805081

README 里有一句聲明：這不是谷歌官方支持的產品

This is not an officially supported Google product

但掛在官方 org 下、主要開發者 Justin Poehnelt 是谷歌 Workspace 開發者關系團隊的成員，Addy Osmani 親自背書。這個項目的定位大概是「谷歌認可，但不做服務承諾」

它在解決一個具體問題

我先說個觀點：
那些對人類「界面友好」的產品，對 Agent 并不友好

過去三十年，所有主流生產力軟件都是為人的眼睛和鼠標設計的。郵件、文檔、日歷、云盤，全部是點擊和拖拽。Agent 來了，它不能點擊，也看不懂網頁界面。

Agent 所需要的，是：發一個命令，收到結構化的數據，然后繼續干活

Google Workspace CLI 把 Google Workspace 的所有 API，包成了一行行 Agent 可以直接調用的命令，結果全部是 JSON，可以直接解析和處理

比如，讓 Agent 列出最近的 10 個文件：

gws drive files list --params '{"pageSize": 10}'

比如，新建一個表格：

gws sheets spreadsheets create --json '{"properties": {"title": "Q1 預算"}}'

比如，發一條 Chat 消息（--dry-run 是預覽模式，不會真的發出去）：

gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "部署完成"}' \
  --dry-run

所有輸出，包括報錯，都是 JSON

覆蓋 Google Workspace 的全部主要產品

Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin，以及其他所有 Workspace API，都在支持范圍里

覆蓋產品范圍占位

有一個設計值得單說：它不預設命令列表

每次運行時，它直接去讀谷歌自己的 API 目錄（Discovery Service），實時生成命令。谷歌哪天新增了一個 API，這個工具自動就能用，不需要等版本更新

認證方面覆蓋了所有場景：本地登錄、CI 環境、服務器端 Service Account，以及直接傳入已有的 token

并且，這些憑證在本地加密存儲

Agent 接入有三種方式

無論用哪種 Agent 工具，都可以接進來

作為命令行工具直接用
安裝之后，Agent（比如 Claude Code、OpenClaw 等）可以直接調用 shell 命令，拿到 JSON 結果。一個人同時調度多個 Agent 處理 Workspace 里的事務，靠的就是這層接口

作為 MCP Server
一行命令啟動：

gws mcp -s drive,gmail,calendar

之后在 Claude Desktop、Gemini CLI、VS Code 等任何支持 MCP 的客戶端里，都可以直接調用這些工具

通過 Skills 接入
倉庫里內置了 100 多個 SKILL.md 文件，覆蓋所有支持的 API，還有針對 Gmail、Drive、Docs、Calendar、Sheets 的 50 個常用操作配方

# 一行命令安裝全部
npx skills add https://github.com/googleworkspace/cli

OpenClaw 用戶可以直接 symlink 進去，工具檢測到沒有安裝時會自動提示安裝

OpenClaw 的作者，想一決高下

Peter Steinberger 是 OpenClaw 的開發者，別人是當紅炸子雞，他是當紅的小龍蝦

他幾個月前自己做了一個叫 gog 的 Google Workspace CLI（gogcli.sh），起因正是覺得市面上沒有好用的同類工具

今天，Google Workspace CLI 發布的時候，他在推特上回應說：會跑 eval 測試，看看哪個工具更適合 Agent 用，「但看到需要的 JSON 命令格式，我不太確定了」

https://x.com/i/status/2029363714642837806

兩個工具的命令風格確實不同。gog 更接近日常語言：

gog gmail search 'newer_than:7d'

Google Workspace CLI 更接近 API 原始結構：

gws drive files list --params '{"pageSize": 5}'

對 Agent 來說，封裝層越高、命令越接近自然語言，理解成本越低，出錯機會也越少。eval 結果出來之前，哪種更適合 Agent，沒有定論

Addy Osmani 在推文里說歡迎 Peter 提 feature request

還有一個細節

倉庫根目錄有一個 AGENTS.md，和 README.md 并排放著

https://github.com/googleworkspace/cli/blob/main/AGENTS.md

這是專門寫給 AI 編程助手（比如 Claude Code）的開發貢獻指南，告訴它怎么給這個項目寫代碼、提 PR、做安全校驗

文件里有一句話值得留意：「這個 CLI 經常被 AI Agent 調用，寫代碼時永遠假設輸入可能是惡意的」

開發者已經默認自己的代碼庫會被 AI 參與維護，同時也默認調用方會是 Agent

gog 倉庫里也有同名文件，格式一致。這大概會成為開源項目的標配之一

另外，這個工具支持接入 Google Cloud 的 Model Armor，在 API 返回內容到達 Agent 之前，自動掃描是否存在 prompt injection 攻擊，可以設置成警告或者直接攔截。Agent 作為調用方，本身也是攻擊面，這個設計在說同一件事

當前版本 v0.3.4，仍在活躍開發，v1.0 之前可能有 breaking changes

GitHub：https://github.com/googleworkspace/cli

https://github.com/googleworkspace/cli