Gemini 搜索

使用 Google 搜索溯源的 Gemini 网页搜索

OpenClaw 通过内置的 Google 搜索接地支持 Gemini 模型。该功能基于实时 Google 搜索结果生成 AI 综合答案，并附带引用。

获取 API 密钥

创建密钥

前往 Google AI Studio 并创建一个 API 密钥。

存储密钥

在 Gateway 网关环境中设置 GEMINI_API_KEY、复用 models.providers.google.apiKey，或通过以下命令配置专用的 Web 搜索密钥：

openclaw configure --section web

配置

{
  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 搜索接地生成带有行内引用的 AI 综合答案。结果同时包含综合答案和来源 URL。

Gemini 接地返回的引用 URL 会通过 OpenClaw 受 SSRF 防护的获取路径发出 HEAD 请求，从 Google 重定向 URL 自动解析为直接 URL （跟随重定向并验证 http/https）。
重定向解析使用严格的 SSRF 默认设置，因此会阻止重定向到私有/内部目标。

支持的参数

Gemini 搜索支持 query、freshness、date_after 和 date_before。

为兼容共享的 web_search，接受 count，但 Gemini 接地仍会返回一个带引用的综合答案，而不是包含 N 个结果的列表。

freshness 接受 day、week、month、year，以及共享的快捷值 pd、pw、pm 和 py。day/pd 会向 Gemini 查询添加时效性指令，而不是采用严格的 24 小时时间范围。week、month、year，以及显式的 date_after/date_before 范围会设置 Gemini Google 搜索接地的 timeRangeFilter。不支持 country、language 和 domain_filter。

模型选择

默认模型为 gemini-2.5-flash（速度快且经济高效）。可以通过 plugins.entries.google.config.webSearch.model 使用任何支持接地的 Gemini 模型。

基础 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；自定义代理路径在移除末尾斜杠后会按原样保留。