🐧 Linux / WSL
🍎 macOS

gog CLI
Google OAuth
OpenClaw
keyring
systemd

📋 こんな方に役立ちますよ

OpenClawなどのAIエージェントフレームワークで、Google Calendar、Gmail、DriveなどをCLIで操作したいのに、OAuth認証の設定でつまずいている方！特にヘッドレス環境（WSL、サーバー）でブラウザなしでOAuthを通す必要がある場合、このガイドがぴったりですよ。

🔍 gog CLIって何ですか？

gogはGoogle Workspace（Gmail、Calendar、Drive、Contacts、Sheets、Docs）をコマンドラインから操作できるCLIツールです。OpenClawのようなAIエージェントフレームワークでスキルとして自動検出されますが、実際に使うにはOAuth認証と環境変数の設定が別途必要ですよ。

既存のgoogle-calendarスキルとは別物で、gogは独自のOAuthストレージ（~/.config/gogcli/）を使います。

⚙️ Step 1: credentials.jsonの作成

Google Cloud ConsoleでOAuth 2.0 Client IDを作成し、credentials.jsonファイルを生成します。

{
  "installed": {
    "client_id": "{your-client-id}.apps.googleusercontent.com",
    "client_secret": "{your-client-secret}",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "redirect_uris": ["http://localhost"]
  }
}

このファイルを~/.config/gog/credentials.jsonに保存してくださいね。

⚙️ Step 2: gogにcredentialsを登録

gog auth credentials ~/.config/gog/credentials.json

実行すると、gogが自動的に~/.config/gogcli/credentials.jsonにコピーしてくれますよ。

⚙️ Step 3: OAuth認証（manualモード）

WSLやヘッドレスサーバーのようにブラウザがない環境では、--manualオプションを使いますよ。

GOG_KEYRING_PASSWORD="{your-password}" gog auth add {your-email}@gmail.com \
  --services calendar,gmail,drive,contacts,docs,sheets \
  --manual --force-consent

実行するとURLが一つ出力されます：

1. そのURLをブラウザ（別のPCでもOK）で開いてGoogleアカウントでログイン
2. 権限を許可するとlocalhostにリダイレクトされます（ページが表示されないのは正常です！）
3. ブラウザのアドレスバーのURL全体をコピーしてターミナルに貼り付け

📁 トークン保存構造

認証完了後、トークンはこのように保存されますよ：

~/.config/gogcli/
├── credentials.json                          # OAuthクライアント情報
└── keyring/
    └── token:default:{your-email}@gmail.com  # 暗号化されたrefresh token

トークンはGOG_KEYRING_PASSWORDでAES暗号化されて保存されます。パスワードなしでアクセスするとエラーになり、パスワードが違ってもエラーになりますよ。

🔑 環境変数の設定 — ここが核心です！

gogがkeyringを復号するにはGOG_KEYRING_PASSWORD環境変数が必須です。そして3箇所すべてに設定する必要がありますよ。

(1) openclaw.json — エージェントスキル設定

"gog": {
  "enabled": true,
  "env": {
    "GOG_KEYRING_PASSWORD": "{your-password}",
    "GOG_ACCOUNT": "{your-email}@gmail.com"
  }
}

(2) ~/.bashrc — 対話型シェル用

# gog CLI keyring password
export GOG_KEYRING_PASSWORD="{your-password}"
export GOG_ACCOUNT="{your-email}@gmail.com"

(3) systemdサービスファイル — 最重要！

ファイル: ~/.config/systemd/user/openclaw-gateway.service

Environment=GOG_KEYRING_PASSWORD={your-password}
Environment=GOG_ACCOUNT={your-email}@gmail.com

設定変更後は必ず：

systemctl --user daemon-reload
openclaw gateway restart

🔧 トラブルシューティング

❌ aes.KeyUnwrap(): integrity check failed

# 破損トークンを削除
rm ~/.config/gogcli/keyring/token\:{your-email}@gmail.com
# defaultトークンのみ残す (token:default:{your-email}@gmail.com)

❌ no TTY available for keyring file backend password prompt

❌ context deadline exceeded（トークン交換タイムアウト）

✅ 検証コマンド

# 認証状態の確認
GOG_KEYRING_PASSWORD="{your-password}" gog auth list

# カレンダーイベント取得テスト
GOG_KEYRING_PASSWORD="{your-password}" gog calendar events primary --max 5

# キーリングファイルの確認
ls -la ~/.config/gogcli/keyring/

📌 まとめ

Googleがどんなに厳重に鍵をかけても、正しい鍵（credential + 環境変数）さえあれば必ず開きますよ！🔑✨