gws 是什麼、怎麼安裝使用：Google Workspace 命令行工具與 Agent Skills（讓智能體操作 Gmail、Drive、日曆、表格）

本文根據 googleworkspace/cli 倉庫 README 與 skills.sh 榜單整理，資料核對於 2026-10-11。項目仍在快速迭代，以倉庫 README 為準。

是什麼

gws 的口號是「一個命令行工具管整個 Google Workspace——為人和 AI 智能體而建」：Drive、Gmail、日曆以及每一個 Workspace API，輸出結構化 JSON，並附帶面向智能體的技能。它和本站介紹過的飛書 CLI 是同一類東西：把辦公套件的能力變成智能體可以調用的命令。

它有一個巧妙的設計：不內置固定的命令清單。gws 在運行時讀取 Google 自己的 Discovery Service，動態生成全部命令，所以 Workspace 新增接口後它會自動支持。

README 頂部有兩條重要提示：第一，這不是 Google 官方支持的產品（儘管倉庫在 googleworkspace 組織下）；第二，項目處於活躍開發中，走向 1.0 的過程裏會有破壞性變更。

截至 2026-10-11，GitHub 顯示該倉庫約 3.1 萬 Star、1861 Fork，最近一次推送在 2026-10-06。

包含哪些 Skill

README 的說法是倉庫附帶 100 多個 Agent Skills：每個受支持的 API 一個，加上常見工作流的高層輔助技能，以及 50 個針對 Gmail、Drive、Docs、日曆和表格的精選「配方」。skills.sh 當日榜單上能看到 gws-gmail、gws-gmail-send、gws-drive、gws-calendar、gws-sheets、gws-docs 和共享基礎技能 gws-shared。完整清單見倉庫的 docs/skills.md。

怎麼安裝

先裝命令行工具：

bash
npm install -g @googleworkspace/cli

macOS 也可以用 brew install googleworkspace-cli，或從 GitHub Releases 下載預編譯的二進制文件。

再裝技能——全部安裝，或只裝某一個產品的：

bash
npx skills add https://github.com/googleworkspace/cli
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

Gemini CLI 用 gemini extensions install https://github.com/googleworkspace/cli。

認證是門檻：README 寫明需要一個 Google Cloud 項目來提供 OAuth 憑據，並給了幾種認證流程（本機交互式、手動配置、瀏覽器輔助、無介面環境）。

怎麼用

• 「列出我 Drive 裏最近修改的 10 個文件」；
• 「把這份銷售數據建成一個新的表格，並共享給團隊」；
• 「看看我明天的日程，把衝突的會議列出來」；
• 「起草一封回覆這封電郵的信，先別發」。

適合誰 / 不適合誰

適合： 工作流程在 Google Workspace 裏的個人和團隊；想給智能體接入電郵、日曆、文檔能力的開發者。

不適合： 無法穩定訪問 Google 服務的網絡環境；不願意自己配置 Google Cloud 項目和 OAuth 的普通用戶；要求穩定接口的生產系統（項目尚未到 1.0）。

注意事項

• 許可證：Apache-2.0。
• 權限範圍要收緊：OAuth 授權時只勾選必需的範圍。給了發電郵和刪文件的權限，智能體就真的能發電郵和刪文件——發送、刪除、對外共享這類操作應要求它先給你確認。
• 提示詞注入：電郵和文檔的內容會進入智能體上下文，別人發來的電郵裏可能藏着誘導它執行操作的文字。不要讓它在無人確認的情況下自動處理收件箱並執行電郵裏的「指示」。
• 企業帳號：公司的 Workspace 可能限制第三方 OAuth 應用，使用前確認管理員政策。
• 「非官方支持」意味着出了問題沒有 Google 的支持渠道可以求助。