> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Поиск Gemini

OpenClaw поддерживает модели Gemini со встроенным
[обоснованием через Google Search](https://ai.google.dev/gemini-api/docs/grounding),
которое возвращает синтезированные ИИ ответы на основе актуальных результатов Google Search
со ссылками на источники.

## Получение ключа API

**1. Создайте ключ**

Перейдите в [Google AI Studio](https://aistudio.google.com/apikey) и создайте
ключ API.

**2. Сохраните ключ**

Задайте `GEMINI_API_KEY` в окружении Gateway, повторно используйте
`models.providers.google.apiKey` или настройте отдельный ключ для веб-поиска с помощью:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw configure --section web
```

## Конфигурация

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`.

При установке Gateway поместите ключи окружения в `~/.openclaw/.env`.

## Принцип работы

В отличие от традиционных поисковых провайдеров, возвращающих список ссылок и фрагментов,
Gemini использует обоснование через Google Search для создания синтезированных ИИ ответов
со встроенными ссылками на источники. Результаты содержат как синтезированный ответ, так и
URL-адреса источников.

* URL-адреса ссылок на источники из обоснования Gemini автоматически преобразуются из
  URL-адресов перенаправления Google в прямые URL-адреса с помощью запроса HEAD через
  защищенный от SSRF механизм получения данных OpenClaw (переход по перенаправлениям,
  проверка http/https).
* При разрешении перенаправлений применяются строгие настройки SSRF по умолчанию, поэтому
  перенаправления на частные или внутренние адреса блокируются.

## Поддерживаемые параметры

Поиск Gemini поддерживает `query`, `freshness`, `date_after` и `date_before`.

`count` принимается для совместимости с общим `web_search`, но обоснование Gemini
по-прежнему возвращает один синтезированный ответ со ссылками на источники, а не список
из N результатов.

`freshness` принимает `day`, `week`, `month`, `year` и общие сокращения
`pd`, `pw`, `pm` и `py`. `day`/`pd` добавляет в запрос Gemini
указание на актуальность вместо жесткого диапазона в 24 часа. `week`, `month`, `year` и явные
диапазоны `date_after`/`date_before` задают
`timeRangeFilter` для обоснования Gemini через Google Search. `country`, `language` и `domain_filter` не поддерживаются.

## Выбор модели

Модель по умолчанию — `gemini-2.5-flash` (быстрая и экономичная). Через
`plugins.entries.google.config.webSearch.model` можно использовать любую модель Gemini,
поддерживающую обоснование.

## Переопределение базового URL

Задайте `plugins.entries.google.config.webSearch.baseUrl`, если веб-поиск Gemini
должен выполняться через прокси-сервер оператора или пользовательскую конечную точку,
совместимую с Gemini. Если значение не задано, веб-поиск Gemini повторно использует `models.providers.google.baseUrl`. Простое
значение `https://generativelanguage.googleapis.com` нормализуется в
`https://generativelanguage.googleapis.com/v1beta`; пользовательские пути прокси-сервера сохраняются
в указанном виде после удаления завершающих косых черт.

## См. также

* [Обзор веб-поиска](https://docs2.openclaw.ai/ru/tools/web.md) — все провайдеры и автоматическое обнаружение
* [Brave Search](https://docs2.openclaw.ai/ru/tools/brave-search.md) — структурированные результаты с фрагментами
* [Perplexity Search](https://docs2.openclaw.ai/ru/tools/perplexity-search.md) — структурированные результаты и извлечение содержимого