Поиск 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-адреса с помощью запроса 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 для обоснования Gemini через Google Search. 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 — структурированные результаты и извлечение содержимого