Настройка Search Provider в OpenClaw: как научить AI Agent искать в интернете (2026)

Кратко

При настройке OpenClaw через onboard вам задаётся вопрос: «Choose a search provider». Многие на этом шаге просто нажимают Enter и пропускают — а потом обнаруживают, что их Agent ничего не знает о событиях после 2024 года.

Search Provider даёт OpenClaw Agent возможность искать в интернете. В этой статье сравниваются три решения — Tavily, Google Custom Search и Bing Search — по способу настройки, ценам и бесплатным лимитам.

Зачем Agent нужна возможность поиска

Представьте ситуацию. Вы просите OpenClaw Agent найти «как называется последняя модель Claude в марте 2026», и Agent уверенно выдаёт устаревшее название.

Это не значит, что модель глупая — просто обучающие данные модели имеют дату отсечки. Данные GPT-5.4 заканчиваются в конце 2025 года, Claude Opus 4.6 — в середине 2025-го. Ни одна модель не может ответить на вопросы о событиях после даты отсечки — если только не умеет искать в интернете.

Что происходит с Agent без поиска:

• Спросите актуальные новости → выдумывает или отказывается отвечать
• Запросите свежую техническую документацию → даёт информацию о старой версии
• Уточните цены и наличие → «угадывает» по обучающим данным
• Попросите проверить факт → не может верифицировать, склонен к галлюцинациям

С подключённым поиском рабочий процесс Agent меняется:

1. Получает вопрос → определяет, нужна ли актуальная информация
2. Вызывает Search Provider для поиска релевантного контента
3. Внедряет результаты поиска в контекст
4. Генерирует ответ на основе результатов поиска + возможностей модели

Разница — как между экзаменом с закрытыми материалами и экзаменом с открытыми. Для задач, требующих актуальной информации, поиск напрямую определяет, можно ли вообще использовать Agent.

Что такое OpenClaw Search Provider

При инициализации OpenClaw командой onboard последовательно настраиваются три компонента:

1. AI Model Provider — «мозг» Agent (GPT/Claude/DeepSeek и др.)
2. Search Provider — поисковый движок Agent (Tavily/Google/Bing)
3. Channel — канал связи Agent (Telegram/Feishu/Discord и др.)

Search Provider — это второй шаг. Это не встроенная способность модели, а интерфейс вызова инструмента, предоставляемый фреймворком OpenClaw. Когда Agent решает, что нужен поиск, он отправляет запрос через этот интерфейс, получает результаты и формирует ответ.

Технически OpenClaw использует механизм function calling / tool use. Search Provider регистрируется как один из доступных инструментов Agent, и модель самостоятельно решает, когда вызвать поиск. Вам не нужно запускать поиск вручную — Agent сам определяет необходимость.

После настройки информация сохраняется в ~/.openclaw/config.yaml:

search:
  provider: tavily          # Поисковый провайдер: tavily / google / bing
  api_key: tvly-xxxxx       # API Key соответствующего провайдера

Всё просто. Рассмотрим каждое решение подробнее.

Три решения подробно

Решение 1: Tavily (рекомендуется)

Tavily — поисковый API, разработанный специально для AI Agent. В отличие от традиционных поисковых систем, возвращающих набор ссылок, Tavily возвращает структурированные сводки контента — Agent не нужно самостоятельно парсить веб-страницы, данные можно использовать сразу.

Регистрация и получение ключа:

1. Откройте tavily.com, зарегистрируйтесь через GitHub или email
2. После регистрации перейдите в Dashboard
3. На странице API Keys скопируйте ваш ключ (формат: tvly-xxxxxxxxxx)

Весь процесс — менее 1 минуты, привязка карты не требуется.

Почему рекомендуем Tavily:

• Создан для AI: возвращает структурированные данные вместо HTML, Agent обрабатывает их эффективно
• Щедрый бесплатный лимит: 1000 запросов/месяц, в среднем 30+ поисков в день для обычного пользователя
• Прямой доступ из Китая: задержка около 500–1500 мс, дополнительная настройка сети не нужна
• Управление глубиной поиска: режим basic для быстрых ответов, advanced для глубокого извлечения
• Автофильтрация мусора: не возвращает SEO-спам

Пример вызова API:

curl -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "tvly-your-api-key",
    "query": "OpenClaw последняя версия 2026",
    "search_depth": "basic",
    "max_results": 5
  }'

Результат содержит заголовок, URL, краткое содержание и оценку релевантности для каждого найденного результата — Agent может использовать их напрямую.

Тарифные планы:

Решение 2: Google Custom Search

Охват и качество поиска Google не нуждаются в представлении — крупнейшая поисковая система в мире. Однако для использования в AI Agent необходим Google Custom Search JSON API, и настройка чуть сложнее, чем у Tavily.

Шаги подключения:

1. Откройте Google Cloud Console, создайте или выберите проект
2. В библиотеке API найдите Custom Search API и включите его
3. Перейдите на страницу «Учётные данные» и создайте API Key
4. Откройте Programmable Search Engine и создайте поисковый движок
5. В настройках включите «Поиск по всему интернету» (а не только по указанным сайтам)
6. Запишите API Key и Search Engine ID (cx)

Конфигурация OpenClaw:

search:
  provider: google
  api_key: AIzaSy-your-google-api-key
  google_cx: a1b2c3d4e5:your-cx-id     # ID поискового движка

Особенности Google Custom Search:

• Максимальный охват: индекс Google не имеет равных
• Высокое качество результатов: зрелый алгоритм ранжирования
• Скромный бесплатный лимит: всего 100 бесплатных вызовов в день
• Нестабильный доступ из Китая: домен www.googleapis.com в ряде регионов недоступен напрямую
• Два параметра конфигурации: API Key + Search Engine ID — на шаг больше, чем Tavily

Цены:

В пересчёте: около 3000 бесплатных запросов в месяц, сверх — $5/тыс. Цена за единицу ниже Tavily, но ограничение «100 в день» при интенсивном использовании быстро исчерпывается.

Решение 3: Bing Search API

Bing Search API от Microsoft предоставляется через Azure и настраивается через управление ресурсами Azure.

Шаги подключения:

1. Войдите в Azure Portal
2. Нажмите «Создать ресурс», найдите Bing Search v7
3. Выберите ценовой уровень (бесплатный F1 подойдёт)
4. После создания перейдите на страницу «Ключи и конечные точки»
5. Скопируйте Key1 или Key2

Конфигурация OpenClaw:

search:
  provider: bing
  api_key: your-bing-search-api-key

Особенности Bing Search:

• Экосистема Azure: если вы уже используете Azure, интеграция проста
• Доступ из Китая: Azure имеет китайский регион, соединение стабильное
• Разумный бесплатный лимит: тариф F1 — 1000 запросов в месяц
• Уклон в сторону английского: качество поиска на китайском уступает Google, но для работы достаточно
• Стандартный формат ответа: чистая JSON-структура, но Agent должен сам извлекать сводки

Тарифные планы:

Сравнительная таблица трёх решений

Рекомендации по выбору:

• Большинству пользователей → Tavily. Самая простая настройка, доступен из Китая, бесплатного лимита достаточно, лучшая совместимость с AI
• Нужно лучшее качество поиска на китайском → Google Custom Search. Но учтите проблемы с доступом из Китая
• Уже есть аккаунт Azure → Bing Search. Низкая стоимость интеграции, стабильный доступ из Китая
• Не уверены, что выбрать → Начните с Tavily, потом можно переключиться в любой момент

Практическая настройка поиска в OpenClaw

Способ 1: Пошаговая настройка через onboard (для новичков)

Если вы ещё не инициализировали OpenClaw, команда onboard проведёт вас через настройку:

openclaw onboard

В процессе настройки вам последовательно зададут вопросы:

? Choose your AI model provider: (Use arrow keys)
  > OpenAI
    Anthropic
    Ofox (API Aggregator)
    ...

? Choose a search provider: (Use arrow keys)
  > Tavily (recommended)
    Google Custom Search
    Bing Search
    Skip

? Enter your Tavily API Key: tvly-xxxxxxxxxx

Выберите Search Provider, введите соответствующий API Key — конфигурация автоматически сохранится в ~/.openclaw/config.yaml.

Способ 2: Ручное редактирование конфигурационного файла

Для тех, кто уже прошёл инициализацию — просто отредактируйте файл конфигурации:

# Откройте файл конфигурации
vim ~/.openclaw/config.yaml

Конфигурация Tavily:

search:
  provider: tavily
  api_key: tvly-your-api-key-here
  # Необязательные параметры
  max_results: 5              # Количество результатов за один поиск (по умолчанию 5)
  search_depth: basic         # basic или advanced

Конфигурация Google Custom Search:

search:
  provider: google
  api_key: AIzaSy-your-google-api-key
  google_cx: your-search-engine-id
  max_results: 5

Конфигурация Bing Search:

search:
  provider: bing
  api_key: your-bing-api-key
  max_results: 5

После настройки перезапустите OpenClaw для применения изменений.

Способ 3: Комплексная настройка с API-агрегатором

Если вы используете API-агрегатор как провайдера модели, модель и поиск настраиваются независимо:

# Модель через API-агрегатор (один ключ для всех моделей)
model:
  provider: openai_compatible
  base_url: https://api.ofox.ai/v1
  api_key: sk-your-key
  model: anthropic/claude-sonnet-4.6

# Поиск через Tavily (независимая настройка)
search:
  provider: tavily
  api_key: tvly-your-tavily-key

Вызовы модели и поиска идут каждый по своему маршруту. Оплата раздельная, системы не мешают друг другу.

Проверка работоспособности поиска

После настройки протестируйте:

# Запустите диалог OpenClaw
openclaw chat

# Задайте вопрос, требующий актуальной информации
> Какие главные новости на Hacker News сегодня?

Если Agent точно отвечает про свежие новости — поиск настроен успешно. Если отвечает «Я не могу получить актуальную информацию» или даёт устаревшие данные — проверьте конфигурацию.

Продвинутый уровень: оптимизация поисковых результатов

После базовой настройки можно улучшить качество поисковых результатов.

1. Направляйте поисковое поведение через системный промпт

Добавьте руководство по стратегии поиска в определение роли Agent:

# ~/.openclaw/agents/default.yaml
system_prompt: |
  Ты AI-помощник с возможностью поиска в интернете.

  Стратегия поиска:
  - При вопросах об актуальной информации (новости, цены, номера версий и т.д.) обязательно сначала ищи, потом отвечай
  - При поиске отдавай предпочтение английским ключевым словам (результаты богаче)
  - Если результаты поиска нерелевантны вопросу, попробуй другие ключевые слова
  - В ответе указывай источник информации и дату

2. Настройка глубины поиска Tavily

Tavily поддерживает два уровня глубины поиска:

• basic (по умолчанию): быстрый ответ, задержка ~500 мс, подходит для большинства запросов
• advanced: глубокое извлечение содержимого страниц, задержка ~2–5 с, для запросов, требующих детальной информации

search:
  provider: tavily
  api_key: tvly-xxxxx
  search_depth: advanced      # Включайте для более детальных результатов

Рекомендуется использовать basic для повседневных задач и переключаться на advanced при необходимости глубокого исследования темы.

3. Ограничение поисковых доменов

Если ваш Agent специализируется на определённой области, можно ограничить область поиска для повышения релевантности результатов. Google Custom Search нативно поддерживает эту функцию — в настройках Programmable Search Engine можно добавить конкретные сайты.

Tavily также поддерживает параметр include_domains для ограничения области поиска (на уровне кода).

Устранение типичных проблем

Ошибка: Search provider not configured

Причина: в config.yaml отсутствует блок search или формат неверный.

Решение:

# Проверьте файл конфигурации
cat ~/.openclaw/config.yaml

# Убедитесь, что поле search существует и формат корректный
# Внимание: отступы в YAML должны быть пробелами, не табуляцией

Ошибка: Invalid API key for search provider

Причина: API Key недействителен, истёк или при копировании добавились лишние пробелы.

Решение:

1. Заново скопируйте ключ в панели провайдера
2. Убедитесь, что перед и после ключа нет лишних пробелов
3. Ключ Tavily начинается с tvly-, ключ Google — с AIzaSy

Таймаут поиска или отсутствие результатов

Причина: проблемы сетевого подключения или исчерпание бесплатного лимита.

Порядок диагностики:

# Проверьте доступность Tavily
curl -s -o /dev/null -w "%{http_code}" https://api.tavily.com/search \
  -X POST -H "Content-Type: application/json" \
  -d '{"api_key":"tvly-your-key","query":"test"}'

# Код 200 = всё в порядке
# Код 401 = недействительный ключ
# Код 429 = лимит исчерпан
# Таймаут без ответа = проблема сети

Agent никогда не инициирует поиск

Причина: модель не направлена на использование инструмента поиска.

Решение:

1. Убедитесь, что используемая модель поддерживает function calling (GPT-4o, Claude Sonnet/Opus, Gemini Pro — поддерживают)
2. Явно укажите в системном промпте, что Agent может и должен использовать поиск
3. У некоторых моделей (например, DeepSeek) возможности tool use слабее, может потребоваться более чёткое руководство

Google Custom Search недоступен из Китая

Симптом: таймаут при подключении к www.googleapis.com.

Решение:

1. Переключитесь на Tavily или Bing (самый простой вариант)
2. Если Google обязателен — направьте запросы через API-шлюз с зарубежными узлами

Итоги

Логика выбора из трёх решений:

1. Tavily — простейшая настройка, создан для AI, бесплатного лимита хватает для персонального использования
2. Google Custom Search — максимальный охват поиска, но ограниченный бесплатный лимит (100 запросов/день)
3. Bing Search — удобная интеграция при наличии экосистемы Azure

Настройка занимает 5 минут: регистрация поискового сервиса, получение API Key, запись в ~/.openclaw/config.yaml.

Справочные материалы

• Официальная документация OpenClaw — настройка Search Provider — справочник по настройке
• Документация Tavily API — полный справочник API Tavily
• Google Custom Search JSON API — документация API поиска Google
• Bing Search API v7 — документация API поиска Microsoft