# Gemini 搜索

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

- 网址：https://funcoding.ai/agents/openclaw/tools/gemini-search/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/gemini-search

---
OpenClaw 通过内置的
[Google 搜索接地](https://ai.google.dev/gemini-api/docs/grounding)
支持 Gemini 模型。该功能基于实时 Google 搜索结果生成 AI 综合答案，并附带
引用。

## 获取 API 密钥

**创建密钥**

前往 [Google AI Studio](https://aistudio.google.com/apikey) 并创建一个
API 密钥。

**存储密钥**

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

```bash
openclaw configure --section web
```

## 配置

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

## 相关内容

- [Web 搜索概览](https://funcoding.ai/agents/openclaw/tools/web/) -- 所有提供商和自动检测
- [Brave 搜索](https://funcoding.ai/agents/openclaw/tools/brave-search/) -- 带摘要的结构化结果
- [Perplexity 搜索](https://funcoding.ai/agents/openclaw/tools/perplexity-search/) -- 结构化结果 + 内容提取