Google Calendar API セットアップガイド
OpenClaw AI秘書 + Google Calendar 連携

Google Chat Bot（セットアップガイド参照）に加え、AI秘書がユーザーの Google Calendar を直接操作できるようにします。

必要なコンポーネント

• Google Chat Bot セットアップガイドが完了していること
• GCP プロジェクトが作成済みで、サービスアカウントの JSON キーが手元にあること
• Google Workspace の管理者権限（ドメイン全体の委任設定に必要）
• VPS に SSH 接続できること

1. Google Chat Bot セットアップで使用した GCP プロジェクトを選択
2. GCP Console → 「APIとサービス」 → 「ライブラリ」
3. 検索バーに Google Calendar API と入力
4. 「Google Calendar API」 を選択
5. 「有効にする」 をクリック

Google Chat Bot セットアップで作成したサービスアカウントに、ドメイン全体の委任機能を有効化します。

1. GCP Console → 「IAMと管理」 → 「サービスアカウント」
2. Google Chat Bot で作成したサービスアカウントをクリック
3. 「詳細」 タブを開く
4. 「詳細設定」 セクションの 「Google Workspace の全体の委任」 エリアを確認
5. 「Google Workspace のドメイン全体の委任を有効にする」 にチェックを入れる
6. 「保存」 をクリック

メモする情報

サービスアカウントがユーザーの代わりに Google Calendar を操作するために、ドメイン全体の委任を設定します。これにより、サービスアカウントがユーザーに代わって（impersonate）カレンダーの読み書きが可能になります。

仕組み

Google Workspace の管理者が、サービスアカウントにカレンダー操作を許可します。

1. Google Workspace 管理コンソール に管理者アカウントでログイン
2. 「セキュリティ」 → 「アクセスとデータ管理」 → 「API の制御」
3. 「ドメイン全体の委任」 セクションを開く
4. 「新しく追加」（または「API クライアント アクセスを管理する」）をクリック
5. 以下を入力:

6. 「承認」 をクリック

スコープの説明

5-1. gcalcli のインストール

# Python と pip がインストールされていることを確認
python3 --version
pip3 --version

# gcalcli をインストール
pip3 install gcalcli

5-2. サービスアカウント JSON キーの配置

Google Chat Bot セットアップで使用した JSON キーファイルを使います（新たに発行する必要はありません）。

# キーの配置先ディレクトリ作成
mkdir -p /home/ubuntu/.openclaw/credentials/

# ローカルからVPSへ転送（ローカル端末で実行）
scp -i ~/.ssh/tobelucky.pem \
  ~/Downloads/YOUR_SERVICE_ACCOUNT_KEY.json \
  root@85.131.252.54:/home/ubuntu/.openclaw/credentials/gchat-service-account.json

5-3. gcalcli の動作確認

# サービスアカウント + ドメイン委任で認証テスト
# --impersonate-user に対象ユーザーのメールアドレスを指定
gcalcli \
  --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
  --impersonate-user user@example.com \
  list

カレンダー一覧が表示されれば認証成功です。

OpenClaw の AI秘書エージェントが Google Calendar を操作するための設定を行います。

方法 A: シェルツールとして gcalcli を呼び出す

OpenClaw のエージェントが gcalcli コマンドをシェル経由で実行します。

エージェント設定ファイル（BUSINESS.md）に追記

## Google Calendar 操作

以下のコマンドでユーザーの Google Calendar を操作できます。

### 予定の一覧表示
gcalcli --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
  --impersonate-user TARGET_USER@example.com \
  agenda "today" "7 days from now"

### 予定の追加
gcalcli --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
  --impersonate-user TARGET_USER@example.com \
  add \
  --title "会議タイトル" \
  --where "場所" \
  --when "2026-03-15 14:00" \
  --duration 60 \
  --description "会議の詳細"

### 予定の検索
gcalcli --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
  --impersonate-user TARGET_USER@example.com \
  search "キーワード"

### 予定の削除
gcalcli --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
  --impersonate-user TARGET_USER@example.com \
  delete "予定タイトル"

方法 B: MCP サーバーとして Google Calendar を接続（上級）

Google Calendar 用の MCP サーバーを構築し、OpenClaw の MCP クライアントから接続する方法です。より柔軟な操作が可能ですが、追加の開発が必要です。

7-1. CLI での直接確認

1. VPS に SSH 接続
2. gcalcli で今週の予定を取得:

   gcalcli \
     --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
     --impersonate-user user@example.com \
     agenda "today" "7 days from now"

3. テスト予定を追加:

   gcalcli \
     --client-secret /home/ubuntu/.openclaw/credentials/gchat-service-account.json \
     --impersonate-user user@example.com \
     add \
     --title "テスト予定（削除OK）" \
     --when "tomorrow 10:00" \
     --duration 30 \
     --noprompt

4. Google Calendar でテスト予定が表示されることを確認
5. テスト予定を削除

7-2. Google Chat 経由での確認

1. Google Chat で AI秘書にメッセージ送信:

   「今週の予定を教えて」

2. AI秘書がカレンダーの予定一覧を返答することを確認
3. 予定追加のテスト:

   「明日の14時に30分のミーティングを追加して」

4. Google Calendar にミーティングが追加されることを確認

以下は gcalcli でサービスアカウント認証を使う際のコマンド集です。

SA はサービスアカウント JSON のパス、USER は対象ユーザーのメールです。

# 変数定義（毎回入力しなくて済むように）
SA="/home/ubuntu/.openclaw/credentials/gchat-service-account.json"
USER="user@example.com"

「Access denied」エラー

「Calendar API has not been used in project」エラー

• Step 1 で Google Calendar API が有効化されているか確認
• 有効化したプロジェクトと、サービスアカウントのプロジェクトが同じであることを確認

「Service account delegation is not enabled」エラー

• Step 2 で「ドメイン全体の委任を有効にする」にチェックが入っているか確認
• チェックを入れた後、「保存」をクリックしたか確認

予定が追加されない / 表示されない

• 対象ユーザーのメールアドレスが正しいか確認
• カレンダーのタイムゾーンが正しいか確認（日本の場合 Asia/Tokyo）
• gcalcli のバージョンが最新か確認: pip3 install --upgrade gcalcli

gcalcli が見つからない

# パスを確認
which gcalcli

# パスが通っていない場合
export PATH=$PATH:/home/ubuntu/.local/bin

# .bashrc に追記して永続化
echo 'export PATH=$PATH:/home/ubuntu/.local/bin' >> ~/.bashrc