在使用 OpenClaw 打造 AI Agent 工作流程時,串接 Google 服務(Gmail、Google Calendar 等)幾乎是必備步驟。
只要完成這個整合,你的 AI 就能真正開始「幫你做事」,例如:
- 自動讀取信件並整理摘要
- 查詢行事曆安排
- 協助排程與提醒
- 整合工作流程與通知
本篇將帶你從零開始,一步一步完成 OpenClaw 與 Google 的完整串接。
一、建立 Google Cloud Console 專案
首先,你需要在 Google Cloud 上建立一個專案,作為 API 使用的基礎。
操作步驟:
- 前往:
https://console.cloud.google.com/ - 建立新專案(例如:OpenClaw)
- 建立完成後,記下:
- Project ID
- Project Number
這個專案就是之後所有 Google API 的入口。
二、啟用 Google API
建立專案後,下一步就是開啟你要用的服務。
操作位置:
左側選單 →「API 和服務」→「程式庫」
建議啟用:
- Google Calendar API
- Gmail API
這一步很重要,沒開 API 後面會全部失效。
三、設定 OAuth 同意畫面
這一步是讓 Google 知道「你的應用是誰」,並允許授權。
操作步驟:
- 左側 →「OAuth 同意畫面」
- 使用者類型選擇:
外部(External) - 填寫基本資訊:
- 應用程式名稱(例如:OpenClaw)
- 支援電子郵件
重要設定(很多人會卡這裡)
在「測試使用者(Test users)」區域:
一定要加入你的 Google 帳號 Email
否則你會遇到:
- 無法登入
- 授權失敗
- 403 錯誤
四、建立 OAuth 憑證
接下來要產生 OpenClaw 用來登入 Google 的憑證。
操作步驟:
- 左側 →「憑證」
- 點擊「建立憑證」→「OAuth 用戶端 ID」
- 應用程式類型選擇:
電腦版應用程式(Desktop app)
- 建立完成後:
你會拿到:
- Client ID
- Client Secret
並下載一個 JSON 檔
建議處理方式:
將檔案重新命名為:credentials.json
五、安裝 gogcli(Google 整合 Skill)
在 OpenClaw 生態中,Google 整合是透過 gogcli 來完成。
gog 是什麼?
- OpenClaw 的 Google Skill
- 可以連接:
- Gmail
- Google Calendar
- Google Docs
brew install steipete/tap/gogcli
npm install -g clawhub
clawhub install gog
六、進行 Google 授權
安裝完成後,就可以開始授權。
設定憑證
gog auth credentials <你的憑證路徑>
綁定 Google 帳號
gog auth add <你的email> --services gmail,calendar
這會開啟瀏覽器讓你登入 Google 並授權。
七、加入 OpenClaw 授權白名單
讓 OpenClaw Agent 可以呼叫 gog。
操作:
which gog
取得 gog 路徑後:
openclaw approvals allowlist add --agent main "$(which gog)"
八、可能需要:啟動 Tailscale
某些環境下,OpenClaw 需要透過 Tailscale 來進行連線。
sudo brew services start tailscale
啟動後:
- 會跳出登入網址
- 用 Google 帳號登入即可
完成後你可以做什麼?
當串接完成後,你的 OpenClaw 將具備「真正實用」的能力:
Gmail
- 讀取最新信件
- 自動摘要
- 分類重要郵件
Google Calendar
- 查詢未來行程
- 自動排程
- 衝突檢查
AI Workflow
- 每日自動整理工作
- 週計畫生成
- 任務提醒與整合
結語
OpenClaw 本身只是 AI Agent 框架,
真正讓它「有用」的關鍵,在於外部服務的整合。
而 Google 生態(Gmail + Calendar)正是最核心的一塊。
完成這篇教學後,你就已經跨過了:
從「聊天 AI」進化為「自動化助理」的門檻