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

​
获取 API 密钥

1

创建密钥

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

存储密钥

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

​
配置

凭据优先级： 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；自定义代理路径在移除末尾斜杠后会按原样 保留。

​
相关内容