跳轉到主要內容
OpenClaw 支援內建 Google Search grounding 的 Gemini 模型， 可傳回由即時 Google Search 結果支撐、附有引用的 AI 綜合答案。

​
取得 API 金鑰

1

建立金鑰

前往 Google AI Studio 並建立 API 金鑰。
2

儲存金鑰

在閘道環境中設定 GEMINI_API_KEY、重用 models.providers.google.apiKey，或透過以下方式設定專用的網頁搜尋金鑰：
openclaw configure --section web

​
設定

{
  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 網頁搜尋會先使用 plugins.entries.google.config.webSearch.apiKey，接著是 GEMINI_API_KEY， 再接著是 models.providers.google.apiKey。對於基礎 URL，專用的 plugins.entries.google.config.webSearch.baseUrl 會優先於 models.providers.google.baseUrl。 若是閘道安裝，請將環境金鑰放在 ~/.openclaw/.env。

​
運作方式

不同於傳統搜尋提供者傳回連結與摘要片段清單， Gemini 使用 Google Search grounding 產生附有行內引用的 AI 綜合答案。結果同時包含綜合答案與來源 URL。
  • 來自 Gemini grounding 的引用 URL 會透過 OpenClaw 受 SSRF 防護的 擷取路徑（重新導向跟隨、http/https 驗證），經由 HEAD 要求自動從 Google 重新導向 URL 解析為直接 URL。
  • 重新導向解析使用嚴格的 SSRF 預設值，因此會阻擋重新導向到 私有/內部目標。

​
支援的參數

Gemini 搜尋支援 query、freshness、date_after 和 date_before。 count 會為了共用 web_search 相容性而接受，但 Gemini grounding 仍會傳回一個附有引用的綜合答案，而不是 N 筆結果清單。 freshness 接受 day、week、month、year，以及共用捷徑 pd、pw、pm 和 py。day/pd 會為 Gemini 查詢加入近期性指示，而不是硬性的 24 小時範圍。week、month、year，以及明確的 date_after/date_before 範圍，會設定 Gemini Google Search grounding 的 timeRangeFilter。不支援 country、language 和 domain_filter。

​
模型選擇

預設模型是 gemini-2.5-flash（快速且具成本效益）。任何支援 grounding 的 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；自訂代理路徑在去除尾端斜線後會依提供的內容保留。

​
相關