Google 開源 Workspace 命令列工具 gws：把全套辦公套件餵給 AI 智慧體

gws 是 Google Workspace 團隊開源的一個統一命令列工具，把 Gmail、Drive、Docs、Sheets、Calendar、Chat 等整套辦公套件塞進了一個執行檔裡。它的目的很直接，既讓工程師擺脫繁瑣的 curl 和 API 文件，也讓大模型智慧體能直接呼叫現成的工具鏈去操作辦公軟體。

它能做什麼

日常在終端裡管檔案、查日程，你不用再去查複雜的 REST 介面。gws 為每一個資源自帶幫助文件，支援用 dry-run 預覽請求，甚至還能自動處理分頁並以 NDJSON 格式流式輸出。

針對常見的辦公動作，它還內建了一批帶加號字首的快捷指令。比如你可以直接執行 gws gmail +triage 快速彙總未讀郵件，用 gws calendar +agenda 調出今天的日程，或者用 gws workflow +standup-report 一鍵生成晨會彙報，省去手動拼裝引數的麻煩。

面向 AI 智慧體，工具的每一次響應都是嚴格的結構化 JSON。專案倉庫內建了 40 多個開箱即用的智慧體技能，並且已經支援接入 OpenClaw 和 Gemini CLI 擴充套件。大模型讀懂這些技能定義後，不用額外寫膠水程式碼，就能直接接管郵件收發和表格讀寫。

安全性上也考慮了智慧體容易遭遇的問題。gws 整合了 Google Cloud 的 Model Armor，可以在 API 響應內容餵給大模型之前先做提示詞注入清洗，防止惡意郵件內容挾持智慧體許可權。

底層怎麼跑起來的

很多類似工具最大的痛點是介面更新後容易失效，但 gws 並沒有寫死一套靜態命令列表。它在執行時動態讀取 Google Discovery Service，即時生成完整的命令結構。也就是說，只要官方介面新增了方法，命令列就會自動獲得對應功能。

憑證管理上，它支援多種登入模式。本地開發可以直接用 gws auth setup 配合 gcloud 自動完成雲專案配置，系統會通過 AES-256-GCM 將憑證加密儲存在作業系統的鑰匙串中。在無頭伺服器或 CI 環境裡，也可以直接掛載憑證檔案或訪問令牌執行。

需要提醒的是，如果你的 Google Cloud OAuth 應用還在測試模式，個人 Gmail 賬號登入時往往會被限制在 25 個許可權範圍內。由於 gws 推薦的預設預設包含 80 多個介面許可權，測試模式下必須通過引數單獨指定服務，比如只請求 drive、gmail 和 sheets，否則會直接登入報錯。

怎麼安裝與嘗試

專案目前支援通過預編譯二進位制檔案直接放入系統路徑，也可以通過 Homebrew、Nix flake、Cargo 原始碼編譯，或者用 npm 全域性安裝。本地環境只需準備好 Node.js 18 以上版本或直接下載對應系統的執行檔，外加一個開通了 Workspace 訪問許可權的 Google Cloud 專案。

官方在文件中明確註明，這並不是 Google 官方正式支援的商業產品，目前仍處於快速迭代期，在正式進入 1.0 版本之前可能會有破壞性調整。

為什麼重要

我們認為 gws 解決了一個非常實際的痛點：過去想讓大模型幫你整理郵件或處理表格，要麼得接沉重的企業級整合平臺，要麼得自己手寫一套隨時可能失效的 API 包裝器。把整個 Workspace 動態對映成結構化命令列和智慧體技能，等於把呼叫門檻降到了普通終端指令碼的級別。

如果你是個經常搗鼓個人智慧體的開發者，或者團隊正在探索自動化辦公流程，現在就很值得拿一個小號去跑跑它的快捷指令。不過對於生產環境來說，它的破壞性更新風險和測試環境許可權限制依然存在，現階段更適合作為個人效率外掛或原型探索，不必急著替換現有的企業級服務賬號體系。