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

​
API キーを取得する

1

キーを作成する

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

キーを保存する

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

​
設定

認証情報の優先順位: Gemini ウェブ検索では、 最初に 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 対策済み フェッチパスを介した HEAD リクエストにより、Google のリダイレクト URL から 直接 URL へ自動的に解決されます（リダイレクト追跡、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 ウェブ検索を運用者のプロキシまたはカスタムの Gemini 互換エンドポイント経由で ルーティングする必要がある場合は、plugins.entries.google.config.webSearch.baseUrl を設定します。未設定の場合、Gemini ウェブ検索は models.providers.google.baseUrl を再利用します。単純な https://generativelanguage.googleapis.com の値は https://generativelanguage.googleapis.com/v1beta に正規化されます。カスタムプロキシのパスは、 末尾のスラッシュを削除した後、そのまま保持されます。

​
関連項目