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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw підтримує моделі Gemini з вбудованою прив’язкою до Google Search, яка повертає синтезовані ШІ відповіді на основі актуальних результатів Google Search із цитуваннями.

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

1

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

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

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

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

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

{
  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. OpenClaw перетворює ці значення або явний діапазон 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-сумісний endpoint. Якщо це значення не задано, вебпошук Gemini повторно використовує models.providers.google.baseUrl. Звичайне значення https://generativelanguage.googleapis.com нормалізується до https://generativelanguage.googleapis.com/v1beta; користувацькі шляхи проксі зберігаються як надано після обрізання кінцевих скісних рисок.

​
Пов’язане

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