GeminiをOpenClawで使う：モデル設定、APIキー、料金確認

OpenClaw は同梱の google プラグインを通じて Gemini に接続します。GEMINI_API_KEY または GOOGLE_API_KEY を設定し、openclaw onboard --auth-choice gemini-api-key を実行してから、モデルを明示的に設定してください。認証を追加してもデフォルトモデルは変わらないためです。 多くのセットアップ記事が見落としている点は、AI Studio キーを使う場合、OpenClaw には Gemini 用の独立したサーフェスが 3 つあり、それぞれ固有の認証情報、エンドポイント、請求があることです。（Vertex AI は gcloud Application Default Credentials を通じた、別の 4 つ目の認証情報経路であり、ここでは扱いません。）チャットを動作させても Gemini 検索は有効にならず、Gemini 検索を有効にすると、チャットルートが一度も使用しない Google プロジェクトに料金が発生する可能性があります。

Gemini 統合は別途インストールするものではありません。OpenClaw 自体に同梱の google プロバイダープラグインとして含まれています（公式プロバイダープラグイン、2026 年 9 月 21 日）。OpenClaw は MIT ライセンスで公開され、npm では openclaw@2026.9.5 として配布されており、Node >=24.16.0 <25 || >=26.1.0 が必要です（npm レジストリ、2026 年 9 月 21 日）。ソフトウェア自体は無料です。以下では、キーにかかる費用だけを扱います。

3 つの Gemini サーフェス、3 つの認証情報

重要なのは優先順位のルールです。Gemini ウェブ検索はまず plugins.entries.google.config.webSearch.apiKey、次に GEMINI_API_KEY、その後 models.providers.google.apiKey を読み取り、専用の webSearch.baseUrl が models.providers.google.baseUrl より優先されます。OpenClaw はここでモデルプロバイダーのヘッダーを継承しません。これは「モデルプロバイダーのエンドポイントに属するもので、ウェブ検索のエンドポイントとは異なる可能性がある」ためであり、検索リクエストにおける Content-Type、x-goog-api-key、x-goog-api-client の管理も保持します（Gemini 検索ドキュメント、2026 年 9 月 21 日）。2 つのルートは意図的に独立しています。

古いチュートリアルに従う前に注意してください。OpenClaw は「新しい Gemini CLI OAuth または Antigravity OAuth のセットアップは提供しない」と明記し、Google アカウントによるコンシューマー向け Gemini CLI Login のアクセスが 2026 年 6 月 18 日に終了したことを理由として挙げています（プロバイダードキュメント）。Google 自身の 2026 年 5 月 19 日の投稿では、Gemini CLI と Code Assist IDE 拡張機能が Google AI Pro および Ultra の加入者、ならびに無料ユーザーへの提供を停止すると説明しています（Google Developers Blog）。どちらも CLI と IDE のサーフェスに関する記述であり、AI Studio API キーについてではありません。以下で扱うのは API キー経路です。

Gemini API キーの設定

# The bundled google plugin reads either name.
export GEMINI_API_KEY="AIza..."   # or GOOGLE_API_KEY

openclaw onboard --auth-choice gemini-api-key

# Auth alone does not change the default model — set it on purpose.
openclaw models list --provider google
openclaw models set google/<id-from-that-list>

同梱プラグインは、ローテーション用に GEMINI_API_KEYS、GEMINI_API_KEY_1、GEMINI_API_KEY_2 を、単一のオーバーライドとして OPENCLAW_LIVE_GEMINI_KEY も読み取ります（公式プロバイダープラグイン、2026 年 9 月 21 日）。これらは google プラグイン独自の変数として文書化されています。カスタムプロバイダーリファレンスでは、自分で宣言したプロバイダー ID 用の変数としては記載されておらず、キーは apiKey で設定します（$${ENV_VAR} の展開例が示されています）。

最後の行は、見た目以上に重要です。openclaw configure は「プロバイダーを追加または再認証したとき、既存の agents.defaults.model.primary を保持」し、openclaw models auth login も --set-default を渡さない限り同じ動作をします（クイックルール）。Gemini を認証したのに古いモデルから回答が返るのは、バグではなく想定された動作です。

このチュートリアルを含め、どのチュートリアルからもモデル ID をコピーしないでください。設定済みのキーがあると、OpenClaw は Gemini models.list API から Google AI Studio のテキストモデルカタログを更新するため、OpenClaw のリリースなしに新しいバリアントが表示されます。一方、OpenClaw 自身のページでは例として示す ID が一致しておらず、ある箇所では google/gemini-3.5-flash、別の箇所では google/gemini-3.1-flash と google/gemini-3.1-pro-preview を挙げ、検索ツールのデフォルトを gemini-3.6-flash としています。唯一の権威は現在の一覧です。OpenClaw は一部の旧式参照を正規化します。google/gemini-3.1-pro は google/gemini-3.1-pro-preview として「受け付けられ、正規化」されます（公式プロバイダープラグイン）。また、google/gemini-3-pro-preview は「2026-03-09 に廃止」され、代替として google/gemini-3.1-pro-preview が指定されています（プロバイダードキュメント、2026 年 9 月 21 日）。

Gemini API キーで実際に請求されるもの

トークンと検索によるグラウンディングは別々の料金項目ですが、Google のページでは一見すると一つの項目に見えます。Google の料金ページに記載されている、Gemini Developer API の標準ティアにおける1Mトークンあたりの料金は以下のとおりです（最終更新日：2026年9月16日、閲覧日：2026年9月21日）：

最後の列は 2 回読んでください。OpenClaw の Gemini ウェブ検索モデルのデフォルトは gemini-3.6-flash です。これは Gemini 3.x モデルであり、Google の無料階層ではグラウンディングが「利用不可」です。したがって、同じモデルのトークンが無料であっても、標準の Gemini 検索設定には請求対象のプロジェクトが必要です。単位も異なります。OpenClaw 自身が「Gemini 3 のグラウンディングは検索クエリごとに課金され、Gemini 2.5 のグラウンディングはプロンプトごとに課金される」と説明しており、Google も「1 件のリクエストで Google 検索へのクエリが 1 件以上発生する可能性がある。実行された個々の検索クエリごとに課金される」と付け加えています。グラウンディングはトークン料金に加算されます。「Gemini には常に費用が適用されます」（いずれも同じ 料金ページからの引用）。例として、1 か月に Gemini 3.x の検索クエリを 6,500 件実行すると、そのうち 1,500 件に 1,000 件あたり $14 が適用され、検索料金だけで $21.00 になります。トークン料金は別途です。

同じページには、さらに 2 つの検討材料があります。有料階層ではコンテキストキャッシュに加え、費用を 50% 削減できる Batch API が利用できます。また、データ利用に関する記載も逆になります。無料階層のコンテンツは「当社の製品改善に使用」されますが、有料階層のコンテンツは使用されません。常時稼働するアシスタントでは重要な違いです。Gemini は OpenClaw の検索プロバイダーの 1 つにすぎません。DuckDuckGo（「なし（キー不要）」）、SearXNG（「なし（セルフホスト）」）、Parallel Search（無料）（「なし（無料の Search MCP）」）は、ウェブ検索プロバイダーテーブルでキー不要の選択肢として記載されています（ウェブ検索、2026 年 9 月 21 日）。したがって、「そもそも Gemini のグラウンディングが必要か」は妥当な最初の問いです。

OpenAI 互換ゲートウェイ経由で Gemini チャットをルーティングする

OpenClaw の カスタムプロバイダーリファレンスでは、明示的な models.providers.<id> エントリは「デフォルトのベース URL、ヘッダー、またはモデル一覧を上書きしたい場合にのみ」使用すると説明しています。また、ゲートウェイ設定リファレンスには 11 個の api 値が列挙されています。openai-completions、openai-responses、openai-chatgpt-responses、anthropic-messages、google-generative-ai、google-vertex、github-copilot、bedrock-converse-stream、ollama、pi-messages、azure-openai-responses です。v2026.9.7 の設定スキーマでは、2026 年 9 月 25 日に追加された 12 個目の google-interactions も受け付けます。リファレンスにはまだ記載されていませんが、OpenClaw の Google プロバイダーページでは、デフォルトの google-generative-ai トランスポートに代わるオプトイン方式として説明されており、https://generativelanguage.googleapis.com/v1beta で Gemini の Interactions API を使用します。Kunavo の Gemini モデルには、OpenAI 互換サーフェスの POST /v1/chat/completions（チャットエンドポイント）経由で到達します。Kunavo は generativelanguage、v1beta、または Interactions エンドポイントを公開していません。そのため、Google のアダプターはいずれも到達できず、到達可能なルートは 別個のプロバイダー ID であり、リダイレクトされた google プラグインではありません。

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-3-8-flash",
            "name": "Gemini 3.8 Flash",
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 1048576,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/gemini-3-8-flash"
      }
    }
  }
}

ここにある 4 つの詳細は、動作を左右します。スラッグはハイフン区切りです。Kunavo の ID は gemini-3-8-flash であり、Google と OpenClaw の ID はドット区切りなので、これらは異なる文字列です。contextWindow は宣言されています。コンテキストメタデータのないカスタムモデルは 200,000 トークンの予算にフォールバックし、ここで Kunavo のカタログが記録しているウィンドウの大部分（1,048,576 トークン、Google が公開した上限ではなく Kunavo のメタデータ）を無駄にするためです。input は画像を指定します。OpenClaw はカスタムモデルをデフォルトでテキストのみとして扱うためです。cost は省略されています。そのため、このルートでは OpenClaw のローカル見積もりがデフォルトでゼロになります。$0 の表示はメタデータがないことを示すものであり、推論が無料という意味ではありません。

このルートで失われる機能は、推測ではなく文書化されています。OpenAI 自身のホストではないホストに対する api: "openai-completions" では、OpenClaw は compat.supportsDeveloperRole: false を強制し、ネイティブなリクエスト整形を省略します。service_tier なし、Responses または Completions の store なし、プロンプトキャッシュのヒントなし、推論互換のペイロード整形なしです（カスタムプロバイダー）。Gemini 固有の追加機能も対象外です。params.cachedContent は Gemini への直接実行用に文書化され、キーのローテーション変数はプラグイン機能です。また、OpenClaw の thinkingLevel / thinkingBudget マッピングは google プロバイダー用として説明されています。ゲートウェイルートで機能するかどうかは、このページでは検証していません。

Kunavo は埋め込みモデルも、テキスト読み上げモデルまたは音声認識モデルも提供していません。したがって、google プラグインの埋め込みおよび音声の契約は、チャットのルーティング方法にかかわらず Google キーに残ります。

機能については、誰の説明かに注意してください。Google の現在の モデルページでは、モデルごとのトークン上限が表示されなくなっているため、他の場所で引用されているコンテキスト値は、古い情報源のコピーです。Kunavo のカタログは、Gemini の一覧でビジョン、関数呼び出し、ストリーミング、長いコンテキストを示し、gemini-2-5-flash 以外のすべてで思考機能を示しています。各主張の範囲は、それを公開した主体に限られます。まず自分のタスクでツール呼び出しを確認してください。

実際に選択したモデルの料金を計算する

この比較をファミリー全体に拡張するのは、現在は誤りであるため、Google の Standard 階層を基準にモデルごとに比較します。

Kunavo の料金は最新の カタログから、Google の料金は 2026 年 9 月 21 日に確認した料金ページから取得しています。導入期間は 2026 年 12 月 31 日に終了し、その後は Flash の比較が再び逆転します。

これは 測定済みの OpenClaw タスクでも請求上限でもなく、トークン計算による試算です。キャッシュなし、検索なしで、1 週間のアシスタント作業において、キャッシュされていない入力トークンを 4,000,000 個送り、出力トークンを 150,000 個受け取るとします。Kunavo の料金で Gemini 3.8 Flash を使うと $2.49 です。同じ計算を Google の導入時 Flash 料金で行うと $3.56、2027 年の料金では $7.13 に上昇します。同じ量を Kunavo の Gemini 3.6 Flash で実行すると $4.99 になります。これは Google の導入時料金を上回ります。だからこそ、判断すべきなのはプロバイダー名ではなくモデル ID です。

Kunavo のカタログ金額は上限ではなく請求の下限です。アップストリームが料金を報告すると、請求額はカタログ料金と、アップストリーム料金に適用されるマークアップを乗じた金額の大きい方になります。キャッシュ料金、検索グラウンディング、ホスティングはこの例の対象外です。前払いクレジットの最低チャージ額は $10 です。これは資金補充の最低額であり、タスク料金でもサブスクリプションでもありません。詳細は 請求の詳細 と、運用料金全体については OpenClaw の料金 を参照してください。

1 件のリクエストで検証し、その後に両方の台帳を読む

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo
openclaw infer model run --model kunavo/gemini-3-8-flash --prompt "hi" --json

openclaw models list は公開済みのモデル一覧を読み取り、openclaw models status は解決済みのデフォルトと認証状態を表示します。どちらも有料タスクが動作する証明にはなりません。また、既知のプロバイダーでの openclaw models set は、カタログにないモデルを警告だけで保存します。openclaw doctor --json --severity-min info は、ローカルカタログで確認できないアクティブなモデルも表示します（CLI リファレンス）。上記の 1 件のリクエストが、費用を伴う最初の証拠です。

ステータスコードで切り分けます。OpenClaw はローカルの OpenAI 互換サーバーでの model_not_found の特徴を説明しています。そこで挙げられている 3 つのフィールドは、カスタムプロバイダーエントリで設定する 3 つのフィールドと同じです。baseUrl に /v1 が含まれること、/v1/chat/completions バックエンドの場合は api が "openai-completions" であること、models[].id がプロバイダー内の接頭辞なしの ID であることを確認してください。プロバイダー接頭辞は選択時にのみ使用します（トラブルシューティング）。Kunavo でベース URL が正しいことを確認するには、実在する API パスに認証なしでリクエストします。GET https://api.kunavo.com/v1/models は 401 と authentication_error の本文を返します。つまり URL は正しく、キーは正しくありません。ホストだけの URL と /v1 だけのパスは API パスではなく HTML を返すため、どちらかを指すクライアントはモデルに到達する前に失敗します（2026 年 9 月 21 日確認）。403 が返った場合は、いったん停止して内容を確認してください。OpenClaw は、それが「CDN、WAF、ボット管理ルール、リバースプロキシなどのアップストリームセキュリティレイヤーから発生する可能性がある」と警告しており、最小限の curl が成功しても、実際の SDK 形式のリクエストが同じレイヤーを通過できるとは限らないとしています。詳しい説明は モデルが見つからない と Gemini API キーが動作しない を参照してください。

ネイティブルートでは Kunavo の Gemini API キーに関する説明と Google AI Studio から始めてください。ゲートウェイルートでは、API キーでキーを作成し、Kunavo アカウントを開設してから、OpenClaw に最適な APIのカスタムプロバイダー手順に従います。テスト中も動作しているルートを利用可能な状態にしておいてください。

どのような場合にどのルートを選ぶか

まだプロバイダーを設定するのではなく選んでいる段階なら、Gemini API の料金と OpenAI 互換 APIが、その判断の 2 つの側面を説明しています。

よくある質問

このページ用に 2026 年 9 月 21 日に取得した情報：OpenClaw の Google プロバイダー、公式プロバイダープラグイン、Gemini 検索、ウェブ検索、カスタムプロバイダー（概念リファレンスとゲートウェイリファレンスの両方）、クイックルール、CLI モデル、トラブルシューティングの各ドキュメント。Google の Gemini API 料金ページ（最終更新日：2026 年 9 月 16 日）、モデルページ、Google 検索グラウンディングページ、2026 年 5 月 19 日の Developers Blog 投稿。openclaw の npm レジストリエントリ。Kunavo 独自のカタログ。2026 年 10 月 1 日、カスタムプロバイダーの api 値を、ゲートウェイリファレンス、Google プロバイダーページ、v2026.9.7 の OpenClaw 設定スキーマおよびソース内の Interactions トランスポートと照合して再確認しました。このページで行った唯一のライブリクエストは、上記の 401 を記録するための、Kunavo の /v1/models に対する認証なしの GET です。OpenClaw のインストール、Kunavo のエンドポイント、Google のエンドポイントに対するランタイムテストは行っていません。すべての金額は公開料金に基づく例示的な計算です。