Tools

Gemini 検索

OpenClaw は、組み込みの Google Search グラウンディングを備えた Gemini モデルをサポートしています。これは、ライブの Google Search 結果に基づく AI 合成の回答を、引用付きで返します。

API キーを取得する

Create a key

Google AI Studio に移動し、API キーを作成します。

Store the key

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

bash

openclaw configure --section web

設定

json5

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; falls back to models.providers.google.baseUrl            model: "gemini-2.5-flash", // default          },        },      },    },  },  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 は、Google のリダイレクト URL から直接 URL に自動的に解決されます。
リダイレクト解決では、最終的な引用 URL を返す前に、SSRF ガードパス（HEAD + リダイレクトチェック + http/https 検証）を使用します。
リダイレクト解決では厳格な 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 に正規化されます。カスタムプロキシパスは、末尾のスラッシュを削除した後、指定どおりに保持されます。