Skip to main content
OpenClaw підтримує моделі Gemini із вбудованим обґрунтуванням через Google Search, яке повертає синтезовані ШІ відповіді на основі актуальних результатів Google Search із посиланнями на джерела.

​
Отримання ключа API

1

Створіть ключ

Перейдіть до Google AI Studio і створіть ключ API.
2

Збережіть ключ

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

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

Пріоритет облікових даних: вебпошук 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 для обґрунтування Google Search у Gemini. Параметри 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; шляхи власних проксі зберігаються в наданому вигляді після видалення кінцевих скісних рисок.

​
Пов’язані матеріали

  • Огляд вебпошуку — усі постачальники та автоматичне визначення
  • Brave Search — структуровані результати з фрагментами
  • Perplexity Search — структуровані результати та видобування вмісту