OpenClawとGoogle Geminiを連携する方法

AIを使っていると、トークン料金やコンテキスト制限に悩まされることが多いですよね。特に長いドキュメントを読み込ませたり、会話履歴を長く保持しようとすると、すぐにコストが膨らんでしまいます。

実を言うと、AIの世界にはあまり知られていない最高の選択肢があります。Google Geminiの無料枠は、驚くほど太っ腹です。ClaudeやGPTがトークンごとに課金される一方で、Geminiは100万トークンのコンテキストと、安定した無料枠を提供しています。長文の処理が必要なプロジェクトなら、Geminiは外せません。

ここでは、OpenClawでGeminiをセットアップする方法を紹介します。

なぜ Gemini なのか？

機能	Gemini	Claude	GPT-4
無料枠	✅ あり	❌ なし	❌ なし
Context Window	1M tokens	200K tokens	128K tokens
Multimodal	✅ 画像, 音声, 動画	✅ 画像	✅ 画像
速度	高速	中速	中速

必要なもの

セットアップを始める前に、以下を準備してください。

Google アカウント
インストール済みの OpenClaw

Quick Start (5分で完了)

ステップ 1: API Key の取得

Google AI Studio にアクセスします
Google アカウントでサインインします
「Get API Key」→ 「Create API Key」をクリックします
生成されたキーをコピーします

ステップ 2: OpenClaw の設定

方法 A: 環境変数を使用する

export GEMINI_API_KEY="your-api-key-here"

方法 B: CLI で設定する

openclaw config set models.providers.gemini.apiKey "your-api-key-here"

ステップ 3: Gemini をモデルに指定する

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

{
  agents: {
    defaults: {
      model: { primary: "gemini/gemini-2.5-flash" }
    }
  }
}

これで準備完了です。Gemini が使えるようになりました。

OAuth 認証（代替案）

Google アカウントを使用して、API Key を管理せずに安全に認証する方法もあります。

オプション 1: Onboarding Wizard を使う

openclaw onboard を実行します
AI プロバイダーとして「Google」を選択します
「OAuth Authentication」を選びます
ブラウザで Google ログインを完了させます
OpenClaw が認証トークンを安全に保存します

オプション 2: CLI Plugin で認証する

すでに OpenClaw を導入済みの場合は、Gemini CLI 認証プラグインを有効にします：

# Gemini CLI 認証プラグインを有効化
openclaw plugins enable google-gemini-cli-auth

# 認証してデフォルトのプロバイダーに設定
openclaw models auth login --provider google-gemini-cli --set-default

ブラウザが開くので、OAuth 認証を行ってください。完了後は API Key を意識せずに Gemini を利用できます。

Note: OAuth は個人利用に最適です。自動化やサーバーへのデプロイには、API Key を使用してください。

利用可能な Gemini モデル

モデル	最適な用途	Context Window
gemini-2.5-flash	高速なレスポンス	1M tokens
gemini-2.5-pro	複雑な推論	1M tokens
gemini-2.0-flash	バランス重視	128K tokens

モデルの選択方法

{
  agents: {
    defaults: {
      model: {
        primary: "gemini/gemini-2.5-flash",
        fallback: ["gemini/gemini-2.0-flash"]
      }
    }
  }
}

Gemini の無料枠について

Google の無料枠には以下が含まれます：

毎分 60 リクエスト (Flash モデル)
毎分 2 リクエスト (Pro モデル)
100万トークンのコンテキストウィンドウ

個人の利用ケースであれば、この無料枠で十分すぎるほどです。

Rate Limits（制限）

もし制限に達してしまった場合は、以下の対策を検討してください：

制限の緩い Flash モデルに切り替える
リクエストの間に遅延を入れる
Gemini API の有料プランにアップグレードする

高度な設定

プロバイダーのフルセットアップ

{
  models: {
    providers: {
      gemini: {
        apiKey: "your-api-key",
        models: [
          {
            id: "gemini-2.5-flash",
            name: "Gemini 2.5 Flash",
            reasoning: false,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

他のプロバイダーとの組み合わせ

Gemini と他のモデルを混在させることも可能です：

{
  agents: {
    defaults: {
      model: {
        primary: "gemini/gemini-2.5-flash",  // 高速かつ無料
        fallback: ["anthropic/claude-sonnet-4"] // 複雑なタスク用
      }
    }
  }
}

トラブルシューティング

”API key not valid”

API Key を再確認してください：

Google AI Studio にアクセスします
キーがアクティブであることを確認します
コピー時に余計な空白が入っていないか確認してください

”Quota exceeded”

無料枠の制限に達しました：

クォータがリセットされるのを待つ（毎日リセットされます）
制限の緩い Flash モデルに変更する
有料プランへの移行を検討する

”Model not found”

モデル ID が正しいか確認してください：

openclaw models list

gemini/モデル名 という形式になっているかチェックしてください。

解決しない場合は？ AI Setup Assistant を活用してください。OpenClaw のすべてのドキュメントを学習しており、リアルタイムでセットアップのトラブルを解決します。

Gemini と他のプロバイダーの比較

項目	Gemini	Claude	OpenAI
得意分野	長文読解, Multimodal	クリエイティブ, ニュアンス	コーディング, 分析
無料枠	✅ 寛大	❌ なし	❌ なし
Context	1M tokens	200K tokens	128K tokens
Coding	良好	非常に優秀	非常に優秀

おすすめの運用: ドキュメント処理やコストを抑えるためのフォールバックとして Gemini を使い、最高品質の出力が必要なタスクには Claude や GPT を残しておくのが賢い方法です。

次のステップ

OpenClaw をインストールする → — 詳細なインストールガイド
Ollama を使う → — ローカル AI を無料で利用
Telegram と連携する → — スマートフォンから操作
Docker でデプロイする → — 24時間稼働させる

サポートが必要ですか？ OpenClaw Discord に参加するか、公式ドキュメントを確認してください。

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。