Google Workspace 整合

本指南說明如何使用 GoG CLI 將 Google Workspace 與 OpenClaw Ultra 整合。

支援的服務

服務	功能
Gmail	閱讀、傳送、搜尋、整理電子郵件
Calendar	活動、日程、提醒
Drive	檔案管理、分享、搜尋
Docs	建立、編輯、格式化文件
Sheets	試算表操作、資料查詢
Slides	建立和編輯簡報
Contacts	管理和同步聯絡人
Tasks	建立和追蹤任務

必要條件

項目	需求
OpenClaw Ultra	已安裝並設定完成
Google 帳戶	有效的 Gmail/Workspace 帳戶

步驟 1：在 OpenClaw Ultra 中安裝 GoG CLI

1. 開啟 OpenClaw Ultra 並開始新的對話
2. 要求代理安裝 GoG CLI：

   為 Windows 安裝 GoG CLI

3. 代理將協助你從 官方發行版 下載並添加到系統 PATH
4. 驗證安裝：

   gog --version

步驟 2：建立 OAuth 用戶端

1. 前往 Google Cloud Console
2. 建立新專案
3. 啟用所需的 API（Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks）- 根據實際需要
4. 將 OAuth 同意畫面設定為「外部」
5. 在 OAuth 用戶端 建立 桌面應用程式 OAuth 用戶端
6. 下載 JSON 檔案並儲存到安全位置

步驟 3：在 OpenClaw Ultra 中驗證

1. 在對話中提供 OAuth JSON 檔案路徑並驗證：

   gog auth credentials /path/to/your/client_secret.json
   gog auth add [email protected] --services gmail,calendar,drive,docs,sheets,slides,contacts,tasks

2. 瀏覽器視窗將開啟進行授權
3. 授予請求的權限
4. 代理將在所有服務連線時確認

步驟 4：開始管理 Google Workspace

現在你可以在對話中使用自然語言：

Gmail

• 檢查我今天未讀的電子郵件
• 傳送一封關於會議的電子郵件給 [email protected]
• 搜尋關於專案更新的電子郵件

Calendar

• 安排明天下午 2 點的會議
• 顯示我本週的日程
• 建立標題為團隊審查的活動

Drive

• 將此檔案上傳到我的 Drive
• 尋找關於第四季規劃的文件
• 與 [email protected] 分享報告

Docs

• 建立標題為會議記錄的新文件
• 編輯我建立的最後一份文件

Sheets

• 顯示 Sheet1 A1 到 D20 的資料
• 建立預算追蹤的試算表

Slides

• 從這個 markdown 建立簡報
• 更新每週狀態簡報

Contacts

• 顯示 Acme Corp 的聯絡人
• 新增 Jane Doe 為聯絡人

Tasks

• 建立審查提案的任務
• 顯示我本週的任務

安全提示

WARNING

• 僅授予必要的權限
• 定期在 Google 帳戶中檢視已連線的應用程式
• 不再需要時撤銷存取權限

疑難排解

問題	解決方案
驗證失敗	在對話中重新驗證
命令無法運作	驗證 GoG CLI 安裝
同步錯誤	檢查網路連線後重試