Skip to main content
OpenClaw поддерживает модели Gemini со встроенным обоснованием через Google Search, которое возвращает синтезированные ИИ ответы на основе актуальных результатов Google Search со ссылками на источники.

​
Получение ключа API

1

Создайте ключ

Перейдите в Google AI Studio и создайте ключ API.
2

Сохраните ключ

Задайте GEMINI_API_KEY в окружении Gateway, повторно используйте models.providers.google.apiKey или настройте отдельный ключ для веб-поиска с помощью:

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

Приоритет учетных данных: веб-поиск 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 — структурированные результаты и извлечение содержимого