Поиск Gemini

OpenClaw поддерживает модели Gemini со встроенным grounding 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 использует grounding Google Search, чтобы создавать синтезированные ИИ ответы со встроенными цитатами. Результаты включают как синтезированный ответ, так и исходные URL.

• URL цитат из grounding Gemini автоматически преобразуются из URL перенаправления Google в прямые URL.
• Разрешение перенаправлений использует путь защиты от SSRF (HEAD + проверки перенаправлений + валидация http/https) перед возвратом итогового URL цитаты.
• Разрешение перенаправлений использует строгие значения SSRF по умолчанию, поэтому перенаправления на частные/внутренние цели блокируются.

Поддерживаемые параметры

Поиск Gemini поддерживает query, freshness, date_after и date_before.

count принимается для совместимости с общим web_search, но grounding Gemini все равно возвращает один синтезированный ответ с цитатами, а не список из N результатов.

freshness принимает day, week, month, year и общие сокращения pd, pw, pm и py. day/pd добавляет в запрос Gemini инструкцию о недавности вместо жесткого 24-часового диапазона. week, month, year и явные диапазоны date_after/date_before задают timeRangeFilter для grounding Google Search Gemini. country, language и domain_filter не поддерживаются.

Выбор модели

Модель по умолчанию — gemini-2.5-flash (быстрая и экономичная). Любую модель Gemini, которая поддерживает grounding, можно использовать через 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; пути пользовательских прокси сохраняются как переданы после удаления завершающих косых черт.

См. также

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