想讓 OpenClaw 讀取與管理 Google 行事曆，其實不用很久。照這篇操作，大約 5 分鐘就能完成。

---

一、前置準備（Google Cloud）

1. 進入 Google Cloud Console，建立一個新專案
2. 啟用 Google Calendar API
3. 建立 OAuth 同意畫面（選 External，測試模式即可）
4. 建立 OAuth 憑證：
   • 類型選 Desktop app
   • 取得 client_id 與 client_secret 用記事本貼起來 [非常重要]
   • 將自己加入Test User List裡
   • 將資料存取權 明確加入定義內 不然會被擋

二、設定 gcalcli 憑證

在終端機建立Gcalcli依賴項 預先準備元件

有這些

python3-dateutil

gcalcli

oauth2client

google-api-python-client / googleapiclient

python3-httplib2

---

安裝指令：

sudo apt-get update
sudo apt-get install -y gcalcli python3-oauth2client python3-googleapi python3-httplib2 python3-dateutil

在終端機建立 ~/.gcalclirc：

cat > ~/.gcalclirc <<'EOF'
--client-id=你的_client_id
--client-secret=你的_client_secret
--noauth_local_webserver
--nocolor
EOF

chmod 600 ~/.gcalclirc

---

三、測試連線

執行：

gcalcli agenda today tomorrow

第一次會出現 Google 授權連結。
將連結貼至瀏覽器並完成授權後，把驗證碼貼回終端機，成功後即可正常讀取行事曆。

---

四、常見問題（快速排除）

有多個行事曆，新增事件卡住要你選編號
請在設定中指定預設日曆，或新增時加上 --calendar="你的日曆名稱"。

invalid_request (400)
通常是 OAuth 設定有誤，請確認用的是你自己的 client_id/client_secret。

Operation not supported / 無法自動開瀏覽器
改用 --noauth_local_webserver，手動開授權連結即可。