在使用 OpenClaw 打造 AI Agent 工作流程時,串接 Google 服務(Gmail、Google Calendar 等)幾乎是必備步驟
只要完成這個整合,你的 AI 就能真正開始「幫你做事」,例如:

  • 自動讀取信件並整理摘要
  • 查詢行事曆安排
  • 協助排程與提醒
  • 整合工作流程與通知

本篇將帶你從零開始,一步一步完成 OpenClaw 與 Google 的完整串接。

 

一、建立 Google Cloud Console 專案

首先,你需要在 Google Cloud 上建立一個專案,作為 API 使用的基礎。

操作步驟:

  1. 前往:
    https://console.cloud.google.com/
  2. 建立新專案(例如:OpenClaw)
  3. 建立完成後,記下:
    • Project ID
    • Project Number

這個專案就是之後所有 Google API 的入口。

 

二、啟用 Google API

建立專案後,下一步就是開啟你要用的服務。

操作位置:

左側選單 →「API 和服務」→「程式庫」

建議啟用:

  • Google Calendar API
  • Gmail API

這一步很重要,沒開 API 後面會全部失效

 

三、設定 OAuth 同意畫面

這一步是讓 Google 知道「你的應用是誰」,並允許授權。

操作步驟:

  1. 左側 →「OAuth 同意畫面」
  2. 使用者類型選擇:
    外部(External)
  3. 填寫基本資訊:
    • 應用程式名稱(例如:OpenClaw)
    • 支援電子郵件

重要設定(很多人會卡這裡)

在「測試使用者(Test users)」區域:

一定要加入你的 Google 帳號 Email

否則你會遇到:

  • 無法登入
  • 授權失敗
  • 403 錯誤

 

四、建立 OAuth 憑證

接下來要產生 OpenClaw 用來登入 Google 的憑證。

操作步驟:

  1. 左側 →「憑證」
  2. 點擊「建立憑證」→「OAuth 用戶端 ID」
  3. 應用程式類型選擇:

電腦版應用程式(Desktop app)

  1. 建立完成後:

你會拿到:

  • 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」進化為「自動化助理」的門檻