> ## 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

<Steps>
  <Step title="Створіть ключ">
    Перейдіть до [Google AI Studio](https://aistudio.google.com/apikey) і створіть
    ключ API.
  </Step>

  <Step title="Збережіть ключ">
    Установіть `GEMINI_API_KEY` в оточенні Gateway, повторно використайте
    `models.providers.google.apiKey` або налаштуйте окремий ключ для вебпошуку через:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```
  </Step>
</Steps>

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

```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-адреси.
* Розв’язання переспрямувань використовує шлях захисту SSRF (HEAD + перевірки переспрямувань +
  перевірка http/https) перед поверненням остаточної URL-адреси цитування.
* Розв’язання переспрямувань використовує суворі стандартні налаштування 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` (швидка та економічна). Будь-яку модель Gemini,
що підтримує заземлення, можна використовувати через
`plugins.entries.google.config.webSearch.model`.

## Перевизначення базової URL-адреси

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

## Пов’язане

* [Огляд Web Search](/uk/tools/web) -- усі постачальники та автоматичне виявлення
* [Brave Search](/uk/tools/brave-search) -- структуровані результати з фрагментами
* [Perplexity Search](/uk/tools/perplexity-search) -- структуровані результати + витягування вмісту