Tools

Gemini 検索

OpenClaw は、組み込みの Google Search グラウンディングに対応した Gemini モデルをサポートしています。これにより、リアルタイムの Google Search 結果に基づく、引用付きの AI 合成回答が返されます。

API キーを取得する

キーを作成する

Google AI Studio にアクセスし、 API キーを作成します。

キーを保存する

Gateway 環境に GEMINI_API_KEY を設定するか、 models.providers.google.apiKey を再利用するか、次のコマンドで Web 検索専用キーを設定します。

bash

openclaw configure --section web

設定

json5

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // GEMINI_API_KEY または models.providers.google.apiKey が設定されている場合は省略可能            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // 省略可能。models.providers.google.baseUrl にフォールバック            model: "gemini-2.5-flash", // デフォルト          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

認証情報の優先順位: Gemini Web 検索では、最初に plugins.entries.google.config.webSearch.apiKey、次に GEMINI_API_KEY、最後に models.providers.google.apiKey が使用されます。ベース URL については、専用の plugins.entries.google.config.webSearch.baseUrl が models.providers.google.baseUrl より優先されます。

Gateway をインストールする場合は、環境変数のキーを ~/.openclaw/.env に配置します。

仕組み

リンクとスニペットの一覧を返す従来の検索プロバイダーとは異なり、 Gemini は Google Search グラウンディングを使用して、インライン引用付きの AI 合成回答を生成します。結果には、合成された回答とソース URL の両方が含まれます。

Gemini グラウンディングの引用 URL は、OpenClaw の SSRF 対策が施されたフェッチ経路（リダイレクト追跡、http/https 検証）を介した HEAD リクエストにより、 Google のリダイレクト URL から直接 URL へ自動的に解決されます。
リダイレクト解決では厳格な SSRF デフォルト設定を使用するため、プライベートまたは内部ターゲットへのリダイレクトはブロックされます。

サポートされるパラメーター

Gemini 検索は query、freshness、date_after、date_before をサポートします。

count は共通の web_search との互換性のために受け付けられますが、 Gemini グラウンディングは N 件の結果一覧ではなく、引用付きの合成回答を 1 件返します。

freshness には day、week、month、year と、共通の短縮形 pd、pw、pm、py を指定できます。day/pd は厳密な 24 時間の範囲を設定する代わりに、Gemini クエリへ最新性に関する指示を追加します。 week、month、year および明示的な date_after/date_before の範囲は、 Gemini Google Search グラウンディングの timeRangeFilter を設定します。 country、language、domain_filter はサポートされません。

モデルの選択

デフォルトモデルは gemini-2.5-flash（高速で費用対効果に優れる）です。グラウンディングをサポートする任意の Gemini モデルを plugins.entries.google.config.webSearch.model で使用できます。

ベース URL の上書き

Gemini Web 検索を運用者のプロキシまたは Gemini 互換のカスタムエンドポイント経由でルーティングする必要がある場合は、plugins.entries.google.config.webSearch.baseUrl を設定します。これが未設定の場合、Gemini Web 検索は models.providers.google.baseUrl を再利用します。単純な https://generativelanguage.googleapis.com という値は https://generativelanguage.googleapis.com/v1beta に正規化されます。カスタムプロキシのパスは、末尾のスラッシュを削除した後、指定どおりに保持されます。