Перейти до основного вмісту

​
Пошук Gemini

OpenClaw підтримує моделі Gemini із вбудованим Google Search grounding, який повертає синтезовані AI відповіді, підкріплені живими результатами Google Search, із цитуваннями.

​
Отримання API key

1

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

Перейдіть у Google AI Studio і створіть API key.
2

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

Задайте GEMINI_API_KEY у середовищі Gateway або налаштуйте через:
openclaw configure --section web

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

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY is set
            model: "gemini-2.5-flash", // default
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
Альтернатива через середовище: задайте GEMINI_API_KEY у середовищі Gateway. Для встановлення gateway додайте його в ~/.openclaw/.env.

​
Як це працює

На відміну від традиційних провайдерів пошуку, які повертають список посилань і фрагментів, Gemini використовує Google Search grounding, щоб створювати синтезовані AI відповіді з вбудованими цитуваннями. Результати містять і синтезовану відповідь, і URL-адреси джерел.
  • URL-адреси цитувань із Gemini grounding автоматично розв’язуються з URL-адрес перенаправлення Google у прямі URL-адреси.
  • Розв’язання перенаправлень використовує шлях захисту SSRF (HEAD + перевірки перенаправлень + валідація http/https) перед поверненням кінцевої URL-адреси цитування.
  • Розв’язання перенаправлень використовує суворі типові налаштування SSRF, тому перенаправлення на приватні/внутрішні цілі блокуються.

​
Підтримувані параметри

Пошук Gemini підтримує query. count приймається для сумісності зі спільним web_search, але grounding Gemini все одно повертає одну синтезовану відповідь із цитуваннями, а не список із N результатів. Специфічні для провайдера фільтри, такі як country, language, freshness і domain_filter, не підтримуються.

​
Вибір моделі

Типова модель — gemini-2.5-flash (швидка й економічна). Можна використовувати будь-яку модель Gemini, яка підтримує grounding, через plugins.entries.google.config.webSearch.model.

​
Пов’язане

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