Day 4
OpenClaw 串接 Gmail、日曆、搜尋 — 整合設定教學
逐步教你將 OpenClaw 連接 Gmail、Google 日曆、Brave 搜尋和瀏覽器工具。包含 OAuth 設定步驟與每個整合的測試指令。
"一個只能聊天的 AI，和一個能讀你的 email、管理日曆、搜尋網路的 AI，差別不在智商，而在它有沒有手。今天我們替它裝上手。"
今日目標
| Learn | 了解 OpenClaw 如何透過 Gmail、日曆、搜尋與瀏覽器串接取得真實世界能力。 |
| Do | 安裝 gog、設定網路搜尋、確認瀏覽器自動化能用，並替每一項都跑一次真實測試。 |
| Done when | 你能查詢真實收件匣、真實日曆、最新搜尋結果，以及一個 live URL，而且過程沒有錯誤。 |
從「會聊天」到「會做事」
你的助理已經會聊天了。今天開始，它會透過 Gmail、日曆、搜尋和瀏覽器串接，直接使用真實資料。
在 OpenClaw 裡，每一項新能力都來自一個 Skill，也就是一組告訴助理如何和外部服務互動的檔案。今天你要串接四項能力：
| Skill | 解鎖什麼能力 | 例子 |
|---|---|---|
| Gmail | 讀取、搜尋、摘要 email | 「今天最需要我回覆的 3 封 email 是哪幾封？」 |
| Google Calendar | 查看、建立、修改事件 | 「我這週有哪些會議？」 |
| Web Search | 搜尋任何資訊 | 「這個月 OpenClaw 有什麼新消息？」 |
| Browser | 打開任意 URL、擷取內容、截圖 | 「競品 X 的定價頁面寫了什麼？」 |
串接四個核心整合
Gmail
- 先準備什麼： 一個已啟用 Gmail API 的 Google Cloud project，以及另存為
credentials.json的 Desktop OAuth 憑證。 - 安裝指令：
clawhub install gog - 要做什麼： 跑安裝流程，完成一次瀏覽器 OAuth，並確認 OpenClaw 已建立
token.json。 - 測試提示： 「幫我看今天最重要的 3 封 email。」
Google Calendar
- 先準備什麼： 同一個 Google Cloud project，另外也要啟用 Google Calendar API。
- 安裝指令：
clawhub install gog - 要做什麼： 重用和 Gmail 相同的 Google 授權，讓 OpenClaw 可以讀取你的真實事件。
- 測試提示： 「我這週有哪些會議？」
Gmail + Calendar 設定（5 步）：
- 前往
console.cloud.google.com→ 建立新的 project - 啟用「Gmail API」和「Google Calendar API」（在 API Library 搜尋）
- 前往「Credentials」→ 建立 OAuth client ID → Desktop app → 下載
credentials.json - 把
credentials.json移到~/.openclaw/workspace/credentials.json - 執行
clawhub install gog— 會打開瀏覽器視窗進行授權
授權完成後，系統會自動建立 token.json。請把它當成私密檔案保護：chmod 600 ~/.openclaw/workspace/token.json
Web Search
- 先準備什麼： 一個搜尋提供商帳號，例如 Brave Search，以及有效的 API key。
- 安裝指令：
openclaw configure --section web - 要做什麼： 把 API key 貼進 wizard，儲存提供商設定後再測試。
- 測試提示： 「這週 AI 圈發生了什麼事？」
Browser
- 先準備什麼： 一套可運作的 OpenClaw 安裝（瀏覽器能力是內建的，不需要額外安裝）。
- 啟用指令：
openclaw browser --browser-profile openclaw status - 要做什麼： 檢查瀏覽器狀態。如果顯示「disabled」，就在設定裡啟用，然後用
openclaw gateway restart重新啟動 gateway。 - 測試提示： 「https://example.com 上寫了什麼？」
為什麼這會徹底改變體驗
在第 4 天之前，「幫我寫一封 email」只會產出一份通用草稿。第 4 天之後，「查看我的 email，並幫我起草回覆合作夥伴詢問」就可以真的讀取對話串、查你的日曆確認時程、搜尋缺少的背景，還能從 live 網頁拉資料。
差別不是 prompt 寫得更好，而是它有真實輸入。
先把安全做好
Gmail、日曆和 Browser 串接完成後，你的助理就會碰到私密資料。從第一天就養成這些習慣：
- API key 不要進 Git。 用環境變數或
.env檔。 - 保護 OAuth token。 設定
chmod 600 ~/.openclaw/workspace/token.json，只讓你的使用者能讀。 - 最小權限原則。 如果你只需要讀 Gmail，就不要授權傳送。
- 把邊界寫進
SOUL.md。 例如：「外部訊息在傳送前必須先確認。」
最低成功標準
- Gmail：問「幫我看今天最重要的 3 封 email。」— 要拿到真實結果
- Calendar：問「我這週有哪些會議？」— 要看到真實事件
- Search：問「這週 AI 圈發生了什麼事？」— 要拿到最新資訊
- Browser：問「[任一 URL] 上寫了什麼？」— 要拿到擷取內容
查看全部 50+ 整合
今天先處理四個最通用、最實用的串接。OpenClaw 總共支援 50+：
openclaw.ai/integrations — 完整整合目錄 →
頻道、模型提供商與工具整合都列在那裡。
常見問題
- OAuth token 權限錯誤： 如果 Google 驗證成功但請求失敗，刪掉舊的
~/.openclaw/workspace/token.json，重新執行clawhub install gog，再設定chmod 600 ~/.openclaw/workspace/token.json。 - 搜尋 API key 不被識別： 重新執行
openclaw configure --section web，貼上你選的提供商對應的正確 key，再在新的對話裡重跑搜尋測試提示。 - Browser 沒有回應： 如果 OpenClaw 連不到瀏覽器，先執行
openclaw browser --browser-profile openclaw status檢查，然後用openclaw gateway restart重啟。再問：「https://example.com 上寫了什麼？」 - 日曆看起來是空的： 確認 Calendar API 已在和 Gmail OAuth 相同的 Google Cloud project 中啟用，然後再用「我這週有哪些會議？」測試一次。
今天到底改變了什麼
你的助理現在可以在收件匣、日曆、搜尋結果和 live 網頁之間來回工作。明天你會把能力擴展到核心工具之外，開始安裝真正貼合你工作流程的技能。