Руководство по выбору поисковых провайдеров для OpenClaw (Brave, Gemini, Grok, Tavily, SerpAPI и др.)

Сложность: Средняя | Время: 20 минут | Результат: Овладение навыками выбора наиболее подходящего поискового Provider для OpenClaw в зависимости от реальных сценариев.

Целевая аудитория

• Разработчики, завершившие базовую настройку OpenClaw и готовые серьезно интегрировать возможности поиска.
• Инженеры, которые не знают, какой из 10 провайдеров выбрать.
• Те, кто хочет глубоко настроить поведение поиска для специфических сценариев (RAG / мониторинг общественного мнения / отслеживание электронной коммерции и т.д.).

Основные зависимости

• OpenClaw (последняя версия)
• Node.js 18+
• API-ключ как минимум одного поискового Provider

Структура проекта

openclaw/
├── config.yaml     # Все конфигурации Provider находятся здесь
└── .env            # Храните API-ключи здесь, не отправляйте в репозиторий

1. Обзор поисковых возможностей OpenClaw

В Agentic Loop OpenClaw поисковый инструмент играет роль "слоя восприятия в реальном времени" — когда Agent понимает, что его обучающих данных недостаточно, он активно вызывает поисковый инструмент для пополнения информации, прежде чем принять решение о следующем шаге.

Вопрос пользователя
   ↓
Размышление Agent: Нужна ли мне актуальная информация?
   ↓ Да
Вызов поискового Provider → Получение результатов
   ↓
Интеграция информации → Генерация ответа

[!TIP]
Без поискового Provider OpenClaw может полагаться только на данные обучения модели. При столкновении с вопросами типа "какая версия последняя" или "сегодняшние новости" он может выдавать недостоверную информацию. Настройка поиска — это первый шаг к тому, чтобы сделать Agent по-настоящему "живым".

На данный момент OpenClaw поддерживает 10 поисковых Provider, разделенных на две категории:

Тип	Provider	Особенности	Бесплатный лимит	Начальная цена
Официальный	Perplexity	Структурированные результаты, фильтрация по времени/домену	Нет	$1/M tokens
Официальный	Brave Search	Приоритет приватности, региональный поиск	~1,000 зап./мес	$5/1k
Официальный	Gemini	Экосистема Google, автоматический Grounding	Достаточный лимит	Оплата за prompt
Официальный	Grok	Двойной поиск: Веб + платформа X	Нет	$10/1k вызовов
Официальный	Kimi	Сверхдлинный контекст 256K	Нет	$0.60/M tokens
Сторонний	Tavily	Оптимизирован для LLM, структурированный вывод	1,000 зап./мес	Pay-as-you-go
Сторонний	Serper.dev	Самый быстрый и дешевый Google SERP	2,500 зап. при рег.	$0.30/1k
Сторонний	SerpAPI	Полный охват движков, поддержка скриншотов	250 зап./мес	$7.50/1k
Сторонний	Exa	Семантический нейросетевой поиск	Пробный период	Pay-as-you-go
Сторонний	DataForSEO	Корпоративный уровень, 10+ движков	$1 бонус	$0.60/1k

2. Основные критерии выбора

Перед выбором Provider согласуйте эти 4 измерения:

Измерение	Ключевой вопрос	Влияние на решение
Актуальность	Насколько свежими должны быть результаты? Реальное время / неделя / месяц?	Для новостей обязателен индекс реального времени
Качество	Нужен список ссылок или предобработанные аннотации?	Для сценариев AI Agent приоритетны аннотации
Стоимость	Каков прогнозируемый объем вызовов в месяц?	В высокочастотных сценариях огромный потенциал экономии
Функционал	Нужен белый список доменов / геопозиция / конкретный движок?	Различия в функциях критичны для узких сценариев

3. Гайд по выбору для 10 основных сценариев

Сценарий 1: Agent для ответов по коду

Характеристики спроса: Пользователь спрашивает "как исправить эту ошибку", "какой API у этой библиотеки последний". Ответы обычно находятся на GitHub, Stack Overflow, в официальной документации.

Рекомендация: Perplexity + searchDomainFilter

Причина в том, что модель sonar от Perplexity лучше всего понимает технический контент, а белый список доменов позволяет принудительно брать результаты только с авторитетных технических ресурсов, избегая некачественных блогов.

tools:
  web:
    search:
      enabled: true
      provider: perplexity
      maxResults: 5
      perplexity:
        apiKey:
          source: env
          provider: default
          id: PERPLEXITY_API_KEY
        model: sonar                # Легкая и быстрая, достаточно
        searchRecencyFilter: month  # Контент за последний месяц
        searchDomainFilter:
          - "github.com"
          - "stackoverflow.com"
          - "docs.python.org"
          - "developer.mozilla.org"
          - "pkg.go.dev"

Результат: При ответах на вопросы по коду источники Agent полностью состоят из доверенных технических сайтов, что значительно повышает достоверность.

---

Сценарий 2: Бот для новостных сводок

Характеристики спроса: Ежедневный сбор свежих новостей в определенных областях (AI / Технологии / Финансы). Актуальность — главный приоритет.

Рекомендация: Serper.dev, type: news

У Serper есть выделенный эндпоинт News, который напрямую подтягивает результаты Google News в реальном времени. Время отклика 1–2 секунды, цена — одна из самых низких.

tools:
  web:
    search:
      enabled: true
      provider: serper
      maxResults: 10
      cacheTtlMinutes: 30       # Кэш новостей на 30 минут
      serper:
        apiKey:
          source: env
          provider: default
          id: SERPER_API_KEY
        type: news              # Переключение на эндпоинт News
        num: 10                 # 10 записей за раз

[!TIP]
Установка cacheTtlMinutes на 30 вполне разумна для новостей — за 30 минут пул новостей существенно не изменится, и повторные вызовы будут пустой тратой ресурсов.

---

Сценарий 3: Agent для академических исследований

Характеристики спроса: Помощь исследователям в поиске статей, анализ прогресса в определенных направлениях. Требуется понимание семантики, а не только совпадение ключевых слов.

Рекомендация: Exa, семантический поиск + фильтрация доменов

Exa основан на векторном поиске (embedding) и понимает запросы типа "применение квантовых вычислений в криптографии", а не просто ищет слова "квантовый", "криптография".

tools:
  web:
    search:
      enabled: true
      provider: exa
      maxResults: 8
      exa:
        apiKey:
          source: env
          provider: default
          id: EXA_API_KEY
        endpoint: auto          # Автоматический баланс скорости и качества
        includeDomains:
          - "arxiv.org"
          - "semanticscholar.org"
          - "pubmed.ncbi.nlm.nih.gov"
          - "nature.com"
          - "science.org"
        startPublishedDate: "2024-01-01"   # Статьи только с 2024 года

Сравнение с обычным поиском: На тот же запрос Exa найдет семантически связанные статьи, даже если ключевых слов нет в заголовке. Релевантность заметно выше.

---

Сценарий 4: Мониторинг настроений в X/Twitter

Характеристики спроса: Отслеживание обсуждений бренда, продукта или темы в X в реальном времени. Обычный веб-поиск практически не индексирует контент X оперативно.

Рекомендация: Grok с включенным x_search

Это уникальная способность Grok — прямой поиск по контенту платформы X, которую другие провайдеры не предоставляют.

tools:
  web:
    search:
      enabled: true
      provider: grok
      grok:
        apiKey:
          source: env
          provider: default
          id: XAI_API_KEY
        model: grok-4-1-fast    # Модель, оптимизированная для агентного поиска
        inlineCitations: true
        tools:
          - type: x_search
            fromDate: "2025-01-01"      # Посты только после указанной даты
            allowedXHandles:            # Опционально: отслеживание конкретных аккаунтов
              - "sama"
              - "karpathy"
              - "ylecun"
          - type: web_search            # Одновременный веб-поиск для контекста
            enableImageUnderstanding: true

[!WARNING]
Каждый вызов инструментов web_search и x_search стоит около $10 за 1000 вызовов. В сценариях частого мониторинга обязательно настройте cacheTtlMinutes или дедупликацию на уровне приложения.

---

Сценарий 5: Мониторинг цен в электронной коммерции

Характеристики спроса: Отслеживание изменения цен конкурентов в Google Shopping или поиск минимальной цены для пользователя.

Рекомендация: SerpAPI, engine: google_shopping

SerpAPI на данный момент — единственный провайдер, который качественно структурирует данные Google Shopping (цена, продавец, рейтинг).

tools:
  web:
    search:
      enabled: true
      provider: serpapi
      maxResults: 20
      cacheTtlMinutes: 60       # Кэш цен на 1 час
      serpapi:
        apiKey:
          source: env
          provider: default
          id: SERPAPI_API_KEY
        engine: google_shopping  # Переключение на движок Shopping
        gl: us                   # Рынок США
        hl: en
        # Опционально: симуляция географического положения
        location: "New York, New York, United States"

Пример возвращаемых данных (структурированный вывод SerpAPI):

{
  "shopping_results": [
    {
      "title": "Название продукта",
      "price": "$29.99",
      "source": "Amazon",
      "rating": 4.5,
      "reviews": 1234,
      "link": "https://..."
    }
  ]
}

---

Сценарий 6: SEO-генерация контента

Характеристики спроса: Пакетный анализ структуры SERP (заголовки, сниппеты, статьи конкурентов) для разработки стратегии контента.

Рекомендация: DataForSEO, mode: normal

Режим normal у DataForSEO работает через очередь (ответ примерно через 5 минут), цена составляет всего $0.0006 за запрос, что в 3 раза дешевле режима реального времени. Для SEO-анализа реальное время обычно не нужно.

tools:
  web:
    search:
      enabled: true
      provider: dataforseo
      maxResults: 10
      cacheTtlMinutes: 1440     # Данные SEO меняются медленно, кэш на 24 часа
      dataforseo:
        login:
          source: env
          provider: default
          id: DATAFORSEO_LOGIN
        password:
          source: env
          provider: default
          id: DATAFORSEO_PASSWORD
        engine: google
        mode: normal            # Режим очереди, $0.0006 за запрос
        locationCode: 2840      # 2840 = США; 2826 = Великобритания; 2392 = Япония
        languageCode: en

[!TIP]
DataForSEO использует цифровые коды locationCode. Популярные коды: США 2840, Великобритания 2826, Германия 2276, Япония 2392. Полный список доступен в официальном справочнике.

---

Сценарий 7: Поиск по внутренним знаниям компании

Характеристики спроса: У компании есть внутренние Wiki и сайты с документацией. Agent должен искать в первую очередь по этим доверенным источникам, игнорируя посторонние сайты.

Рекомендация: Brave Search + Goggles

Функция Goggles в Brave позволяет настраивать правила ранжирования — можно максимально повысить приоритет сайтов с документацией и заблокировать сайты конкурентов.

tools:
  web:
    search:
      enabled: true
      provider: brave
      maxResults: 8
      brave:
        apiKey:
          source: env
          provider: default
          id: BRAVE_API_KEY
        # URL Goggles: создается и публикуется на search.brave.com/goggles
        goggles_id: "https://raw.githubusercontent.com/your-org/goggles/main/internal-docs.goggle"
        freshness: pm           # Поиск контента за последний месяц

Пример конфигурации Goggles (содержимое файла .goggle):

# Приоритет внутренним документам
$boost=10,site=docs.yourcompany.com
$boost=10,site=wiki.yourcompany.com

# Понижение веса сайтов конкурентов
$downrank=5,site=competitor.com

# Блокировка низкокачественных ферм контента
$discard,site=spamsite.example

---

Сценарий 8: Исследование мультиязычных рынков

Характеристики спроса: Глобальный анализ рынка. Требуется симуляция поиска в разных странах/языковых средах для понимания локальной конкуренции.

Рекомендация: SerpAPI с гибкой настройкой location + hl + gl

SerpAPI поддерживает точную симуляцию местоположения, позволяя "притвориться" пользователем из конкретного города.

tools:
  web:
    search:
      enabled: true
      provider: serpapi
      serpapi:
        apiKey:
          source: env
          provider: default
          id: SERPAPI_API_KEY
        engine: google
        # Пример: симуляция пользователя из Берлина, Германия
        location: "Berlin, Berlin, Germany"
        hl: de          # Язык интерфейса: немецкий
        gl: de          # Регион: Германия

Идея для мультиязычной настройки: Динамически передавайте параметры location / hl / gl в задачи Agent. Один Provider покроет весь мир:

Рынок	location	hl	gl
США	New York, New York, United States	en	us
Великобритания	London, England, United Kingdom	en	gb
Германия	Berlin, Berlin, Germany	de	de
Япония	Tokyo, Tokyo, Japan	ja	jp
Франция	Paris, Ile-de-France, France	fr	fr
Бразилия	São Paulo, São Paulo, Brazil	pt	br

---

Сценарий 9: Высокочастотные низкобюджетные задачи

Характеристики спроса: Agent должен часто активировать поиск (например, каждые несколько минут). Стоимость — главный сдерживающий фактор.

Рекомендация: Serper.dev с пакетными тарифами + агрессивное кэширование

Цена Serper при больших объемах может опускаться до $0.30/1k. С разумным кэшированием стоимость станет минимальной по отрасли.

tools:
  web:
    search:
      enabled: true
      provider: serper
      maxResults: 5             # Не берите лишнего
      timeoutSeconds: 15        # Быстрый отказ, не ждем долго
      cacheTtlMinutes: 120      # Кэш на 2 часа
      serper:
        apiKey:
          source: env
          provider: default
          id: SERPER_API_KEY
        type: search
        num: 5

Сравнение затрат (10,000 запросов в месяц):

Provider	Цена за 1k	Стоимость в месяц
SerpAPI	$7.50/1k	$75
Perplexity sonar-pro	~$3/1k	$30
Serper.dev	$0.30/1k	$3
Tavily basic	~$4/1k	$40

С учетом кэша на 2 часа реальное количество платных вызовов обычно снижается до 30%–50% от исходного.

---

Сценарий 10: Бюджет $0 на старте

Характеристики спроса: Личный проект или этап ранней проверки, не хочется тратить деньги, но поиск должен работать.

Стратегия: Ротация бесплатных лимитов трех провайдеров.

Provider	Бесплатный лимит	Итого
Brave Search	~1,000 зап./мес
Tavily	1,000 зап./мес
SerpAPI	250 зап./мес
Всего		~2,250 зап./мес

Настройте API-ключи для всех трех и переключайтесь при исчерпании лимитов:

tools:
  web:
    search:
      enabled: true
      provider: tavily          # Основной: 1000 бесплатных запросов
      maxResults: 5
      cacheTtlMinutes: 60
      tavily:
        apiKey:
          source: env
          provider: default
          id: TAVILY_API_KEY
        searchDepth: basic      # Используйте basic (1 кредит), а не advanced (2)
        maxResults: 5
        includeAnswer: true

[!TIP]
В Tavily Dashboard можно следить за расходом в реальном времени.

4. Таблица быстрого подбора

Сценарий	Рекомендуемый Provider	Ключевой параметр	Эст. стоимость за 1k
Ответы по коду	Perplexity	searchDomainFilter	~$1
Новости	Serper.dev	type: news	$0.30–$1
Исследования	Exa	includeDomains	Pay-as-you-go
Мониторинг X	Grok	x_search	$10
Цены (e-commerce)	SerpAPI	engine: google_shopping	$7.50
SEO-анализ	DataForSEO	mode: normal	$0.60
Внутренние знания	Brave + Goggles	goggles_id	$5
Мультиязычность	SerpAPI	location, gl	$7.50
Массовый поиск	Serper.dev	cacheTtlMinutes: 120	$0.30–$1
Бюджет $0	Tavily / Brave	searchDepth: basic	$0

5. Продвинутый уровень: Резервная стратегия

Для продакшена рекомендуется настроить резервную стратегию — автоматическое переключение при сбое или исчерпании лимита основного провайдера.

tools:
  web:
    search:
      enabled: true
      provider: perplexity      # Основной
      maxResults: 5
      timeoutSeconds: 20        # Переключение через 20 сек ожидания
      perplexity:
        apiKey:
          source: env
          provider: default
          id: PERPLEXITY_API_KEY
        model: sonar

      # Резервный Provider
      fallback:
        provider: serper
        serper:
          apiKey:
            source: env
            provider: default
            id: SERPER_API_KEY
          type: search
          num: 5

6. Устранение неполадок

Q: Провайдер настроен, но Agent не ищет.
A: В system prompt не хватает указания. Добавьте: "Если ты не уверен в актуальности информации, используй инструмент поиска".

Q: В Perplexity searchDomainFilter не работает.
A: Не используйте префикс https://. Пишите просто github.com.

Q: Результаты Serper.dev отличаются от Google.
A: Serper по умолчанию имитирует США. Для локальных результатов добавьте параметр gl: ru (для России) или соответствующий код страны.

---

Дополнительное чтение:

• Руководство по конфигурации Provider в OpenClaw
• Документация Perplexity API
• Brave Search API