OpenClawでGoogle Geminiモデルを接続するチュートリアル

はじめに

Google Gemini は、Google が開発した次世代マルチモーダル AI モデルで、テキスト、画像、音声、動画の高度な理解能力を備えています。OpenClaw は Gemini シリーズモデルを完全にサポートしており、Google が提供する非常に寛大な無料枠は、個人ユーザーや小規模チームに最適です。本チュートリアルでは、Gemini モデルの接続方法を詳しくご紹介します。

事前準備

条件	説明
OpenClaw がインストール済みで正常に動作している	`openclaw doctor` でチェックを通過していること
Google アカウント	Google AI Studio へのログインに使用
ネットワーク環境	Google サービスにアクセスできること

ステップ1：Gemini API Key の取得

1.1 Google AI Studio から取得する（推奨）

最も簡単な取得方法で、個人開発者に適しています：

aistudio.google.com にアクセス
Google アカウントでログイン
左側メニューの Get API key をクリック
Create API key をクリック
既存の Google Cloud プロジェクトを選択するか、新しいプロジェクトを作成
生成された API Key をコピー

API Key の形式例：

AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1.2 利用可能リージョンの確認

Gemini API は一部の地域で利用できない場合があります。2026年時点で以下のリージョンがサポートされています：

アメリカ、カナダ
ヨーロッパの大部分の国
日本、韓国、シンガポール、インド
オーストラリア

お住まいのリージョンがサポートされていない場合は、Vertex AI プラン（後述）の利用をご検討ください。

ステップ2：OpenClaw の設定

2.1 基本設定

OpenClaw の設定ファイルを編集します：

nano ~/.config/openclaw/openclaw.json5

Gemini モデルの設定を追加します：

{
  models: {
    gemini: {
      provider: "google",
      apiKey: "AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      defaultModel: "gemini-2.5-pro",
    }
  }
}

2.2 環境変数でキーを保管する

# ~/.bashrc または ~/.zshrc に追加
export GOOGLE_AI_API_KEY="AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

設定ファイルを環境変数の参照に変更します：

{
  models: {
    gemini: {
      provider: "google",
      apiKey: "${GOOGLE_AI_API_KEY}",
      defaultModel: "gemini-2.5-pro",
    }
  }
}

2.3 サービスの再起動

openclaw restart
openclaw doctor

✓ Google Gemini connection OK と表示されれば、設定は成功です。

ステップ3：Gemini モデルの選択

Google は現在複数の Gemini モデルを提供しており、それぞれに特化した機能があります：

モデル	コンテキストウィンドウ	特徴	推奨シーン
gemini-2.5-pro	1M トークン	最強の推論能力、深い思考	複雑な分析、コード生成、長文処理
gemini-2.5-flash	1M トークン	高速応答、コストパフォーマンスに優れる	日常会話、クイック Q&A
gemini-2.0-flash	1M トークン	前世代の高速モデル	レイテンシに敏感なシーン
gemini-2.0-flash-lite	1M トークン	最軽量モデル	簡単なタスク、高並列処理

3.1 推奨設定プラン

ほとんどのユーザーに、以下の組み合わせを推奨します：

{
  models: {
    "gemini-main": {
      provider: "google",
      apiKey: "${GOOGLE_AI_API_KEY}",
      defaultModel: "gemini-2.5-pro",
      parameters: {
        temperature: 0.7,
        maxTokens: 8192,
      }
    },
    "gemini-fast": {
      provider: "google",
      apiKey: "${GOOGLE_AI_API_KEY}",
      defaultModel: "gemini-2.5-flash",
      parameters: {
        temperature: 0.7,
        maxTokens: 4096,
      }
    }
  }
}

ステップ4：無料枠の詳細

Google AI Studio が提供する無料枠は非常に寛大です：

モデル	無料 RPM（1分あたりのリクエスト数）	無料 TPM（1分あたりのトークン数）	無料 RPD（1日あたりのリクエスト数）
gemini-2.5-pro	5	250,000	25
gemini-2.5-flash	15	1,000,000	500
gemini-2.0-flash	15	1,000,000	1,500
gemini-2.0-flash-lite	30	1,000,000	3,000

個人ユーザーであれば、gemini-2.5-flash の無料枠でほぼ十分です。無料枠を超えた場合は、Google Cloud Console で有料プランを有効にできます。

4.1 無料枠を最大限に活用するコツ

{
  models: {
    gemini: {
      provider: "google",
      apiKey: "${GOOGLE_AI_API_KEY}",
      defaultModel: "gemini-2.5-flash",  // デフォルトは flash、無料枠がより多い
      parameters: {
        maxTokens: 2048,                  // 出力長を制限し、トークンを節約
      }
    }
  },
  rateLimit: {
    gemini: {
      maxRequestsPerMinute: 14,           // 少し余裕を持たせて制限を回避
      maxRequestsPerDay: 480,
    }
  }
}

ステップ5：Vertex AI プラン

エンタープライズグレードのサービスが必要な場合や、お住まいのリージョンで AI Studio がサポートされていない場合は、Google Cloud の Vertex AI を使用できます：

5.1 Vertex AI の有効化

Google Cloud Console にログイン
プロジェクトを作成または選択
Vertex AI API を有効化
サービスアカウントを作成し、JSON キーファイルをダウンロード

5.2 OpenClaw で Vertex AI を使用する設定

{
  models: {
    "gemini-vertex": {
      provider: "google-vertex",
      serviceAccountKeyFile: "/path/to/service-account-key.json",
      projectId: "your-gcp-project-id",
      region: "us-central1",            // 最寄りのリージョンを選択
      defaultModel: "gemini-2.5-pro",
      parameters: {
        temperature: 0.7,
        maxTokens: 8192,
      }
    }
  }
}

5.3 Vertex AI と AI Studio の比較

比較項目	AI Studio	Vertex AI
対象ユーザー	個人、小規模チーム	企業、本番環境
認証方式	API Key	サービスアカウント
無料枠	あり	限定的な無料トライアル
SLA 保証	なし	あり
データ処理場所	保証なし	リージョン指定可能
課金方式	従量課金	従量課金、予約割引対応

ステップ6：マルチモーダル機能の設定

Gemini の大きな魅力は、ネイティブのマルチモーダルサポートです。チャットチャンネルから画像や PDF などのコンテンツを送信すると、Gemini が理解して応答できます。

6.1 画像理解の有効化

{
  models: {
    gemini: {
      provider: "google",
      apiKey: "${GOOGLE_AI_API_KEY}",
      defaultModel: "gemini-2.5-flash",
      capabilities: {
        vision: true,        // 画像理解を有効化
        pdf: true,           // PDF 解析を有効化
        audio: true,         // 音声理解を有効化
      }
    }
  }
}

6.2 対応ファイル形式

ファイル種類	対応形式	説明
画像	PNG, JPEG, WebP, GIF	複数画像の同時入力に対応
ドキュメント	PDF	PDF の内容を抽出・理解可能
音声	MP3, WAV, FLAC	音声認識と理解に対応
動画	MP4, WEBM	動画コンテンツの理解が可能（一部モデル）

ステップ7：よくある問題のトラブルシューティング

API Key が無効

Error: API key not valid. Please pass a valid API key.

API Key が正しくコピーされているか、AIza で始まっているかを確認してください。それでもエラーが出る場合は、AI Studio で再生成してみてください。

リージョン制限

Error: User location is not supported for the API use.

お住まいのリージョンが Gemini API に対応していない可能性があります。解決策：

Vertex AI プランを使用する
OpenRouter 経由で間接的に Gemini を呼び出す（OpenRouter チュートリアルをご参照ください）

無料枠の超過

Error: 429 Resource has been exhausted

解決方法：

gemini-2.0-flash-lite に切り替える（無料枠がより多い）
Google Cloud の有料プランを有効にする
OpenClaw でレート制限を設定して頻繁なトリガーを回避する

レスポンスの途中切断

回答が頻繁に途中で切れる場合は、maxTokens の設定を確認してください：

parameters: {
  maxTokens: 8192,  // 出力制限を引き上げる
}

まとめ

Gemini モデルは、OpenClaw エコシステムにおいてコストパフォーマンスに非常に優れた選択肢です。寛大な無料枠と強力なマルチモーダル機能により、個人ユーザーでもゼロコストで機能豊富な AI アシスタントを運用できます。日常的には gemini-2.5-flash でスピードと品質のバランスを取り、複雑なタスクでは gemini-2.5-pro に切り替えることを推奨します。チームでエンタープライズレベルのニーズがある場合は、Vertex AI プランの検討をおすすめします。