Перейти к основному содержанию
OpenClaw поддерживает модели Gemini со встроенным grounding 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 использует 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 — структурированные результаты + извлечение содержимого