Пошук Gemini

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

Отримайте ключ API

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. 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 -- усі постачальники та автоматичне виявлення
• Brave Search -- структуровані результати з фрагментами
• Perplexity Search -- структуровані результати + витягування вмісту