Skip to main content
OpenClaw 支持带有内置 Google Search grounding 的 Gemini 模型，它会返回由实时 Google Search 结果支持并带有引用的 AI 综合答案。

​
获取 API key

1

创建 key

前往 Google AI Studio 并创建一个 API key。
2

存储 key

在 Gateway 网关环境中设置 GEMINI_API_KEY，复用 models.providers.google.apiKey，或通过以下方式配置专用的 Web 搜索 key：
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 Web 搜索会先使用 plugins.entries.google.config.webSearch.apiKey，然后是 GEMINI_API_KEY，再然后是 models.providers.google.apiKey。对于 base URL，专用的 plugins.entries.google.config.webSearch.baseUrl 优先于 models.providers.google.baseUrl。 对于 Gateway 网关安装，请将环境 key 放在 ~/.openclaw/.env 中。

​
工作原理

与返回链接和摘要列表的传统搜索提供商不同，Gemini 使用 Google Search grounding 来生成带有内联引用的 AI 综合答案。结果同时包含综合答案和来源 URL。
  • Gemini grounding 中的引用 URL 会通过 OpenClaw 受 SSRF 防护的 fetch 路径，使用 HEAD 请求自动从 Google 重定向 URL 解析为直接 URL（跟随重定向、http/https 验证）。
  • 重定向解析使用严格的 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 使用。

​
Base 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；自定义代理路径会在去除尾随斜杠后按提供值保留。

​
相关内容