透過 Google Calendar API 與 Google 日曆互動——列出即將到來的活動、建立新活動、更新或刪除活動。當需要從 OpenClaw 以程式方式存取日曆時使用此技能。
此技能提供 Google Calendar REST API 的輕量級封裝。它可以讓你：
此技能使用 Python 實作 (scripts/google_calendar.py)。它預期設定以下環境變數（你可以使用 openclaw secret set 安全地儲存它們）：
GOOGLE_CLIENT_ID=…
GOOGLE_CLIENT_SECRET=…
GOOGLE_REFRESH_TOKEN=… # OAuth 同意後取得
GOOGLE_CALENDAR_ID=primary # 或特定日曆的 ID
第一次執行此技能時，可能需要執行 OAuth 流程以取得 refresh token——請參閱下方的 設定 章節。
google-calendar list [--from <ISO> --to <ISO> --max <N>]
google-calendar add --title <title> [--start <ISO> --end <ISO>]
[--desc <description> --location <loc> --attendees <email1,email2>]
google-calendar update --event-id <id> [--title <title> ... 其他欄位]
google-calendar delete --event-id <id>
所有指令都會將 JSON payload 列印到 stdout。錯誤會列印到 stderr 並導致非零的 exit code。
client_id 和 client_secret。GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… python3 -m google_calendar.auth
refresh_token。openclaw secret set GOOGLE_CLIENT_ID <value>
openclaw secret set GOOGLE_CLIENT_SECRET <value>
openclaw secret set GOOGLE_REFRESH_TOKEN <value>
openclaw secret set GOOGLE_CALENDAR_ID primary # 可選
pip install --user google-auth google-auth-oauthlib google-api-python-client
腳本從環境變數載入憑證，使用 refresh token 重新整理 access token，建立 service = build('calendar', 'v3', credentials=creds)，然後呼叫相應的 API 方法。
注意： 此技能不需要 GUI；它完全透過 HTTP 呼叫運作，因此適用於無頭伺服器 (headless servers)。