Настройка 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 — по способу настройки, ценам, бесплатным лимитам и доступности из Китая. Поможем выбрать оптимальный вариант и за 5 минут научить Agent «сначала искать, потом отвечать».

Содержание

• Зачем Agent нужна возможность поиска
• Что такое OpenClaw Search Provider
• Три решения подробно
• Сравнительная таблица трёх решений
• Практическая настройка поиска в OpenClaw
• Продвинутый уровень: оптимизация поисковых результатов
• Устранение типичных проблем
• Часто задаваемые вопросы (FAQ)
• Итоги

Зачем 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: Комплексная настройка с Ofox

Если вы используете Ofox как провайдера модели, можно реализовать управление «модель + поиск» в одном месте:

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

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

Таким образом «мозг» Agent (модель) и «поисковый движок» (Search Provider) идут каждый по оптимальному маршруту: вызовы модели через узлы ускорения Ofox с низкой задержкой, поиск через Tavily для актуальной информации. Оплата раздельная, системы не мешают друг другу.

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

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

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

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

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

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

Настройка — это только первый шаг. Чтобы поиск 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-шлюз с зарубежными узлами

Часто задаваемые вопросы (FAQ)

Какая связь между Search Provider OpenClaw и «поиском в интернете» модели?

Прямой связи нет. Модель сама по себе не умеет выходить в интернет — поиск ChatGPT реализован на уровне продукта OpenAI. Search Provider в OpenClaw — это инструмент поиска на уровне фреймворка, который через механизм function calling даёт любой модели возможность искать в интернете. Иными словами, даже если модель сама не поддерживает поиск, через Search Provider OpenClaw она сможет искать информацию в интернете.

Поиск расходует токены AI-модели?

Да. Результаты поиска внедряются в контекст модели как входные данные, поэтому чем больше результатов возвращается, тем больше токенов расходуется. Рекомендуется установить max_results в диапазоне 3–5, балансируя между объёмом информации и стоимостью. Структурированный ответ Tavily здесь имеет преимущество — при том же объёме информации расходуется меньше токенов по сравнению с сырым HTML от Google/Bing.

Можно ли использовать SearXNG или другой самостоятельно развёрнутый поисковый движок?

Официально OpenClaw поддерживает Tavily, Google и Bing. Однако в сообществе уже есть сторонние плагины для SearXNG, Serper, Brave Search и других. Если у вас есть собственный экземпляр SearXNG, его можно подключить через плагин сообщества. Следите за каталогом plugins в GitHub OpenClaw для актуального списка поддержки.

Безопасен ли ключ Search Provider?

Ключ хранится локально в ~/.openclaw/config.yaml и не передаётся ни на какие серверы. OpenClaw — проект с открытым кодом, вы можете проверить это, проведя аудит кода. Рекомендуется установить соответствующие права доступа к файлу конфигурации:

chmod 600 ~/.openclaw/config.yaml

Как управлять использованием поиска в корпоративной среде?

Рекомендуется централизованно получить API Key поиска и распределить его между экземплярами Agent через настройки прав доступа OpenClaw. Тарифный план Business у Tavily поддерживает статистику использования и управление субаккаунтами. В сочетании с командными функциями Ofox можно реализовать единое управление «использование модели + использование поиска» и контроль расходов.

Итоги

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

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

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

Настройка занимает всего 5 минут: регистрация поискового сервиса → получение API Key → запись в ~/.openclaw/config.yaml. В сочетании с сервисом агрегации API Ofox модель и поиск идут каждый по оптимальному маршруту, делая вашего AI Agent умным и хорошо информированным.

Рекомендуемый порядок действий:

1. Начните с бесплатной версии Tavily, запустите поисковый процесс
2. Добавьте в системный промпт руководство по стратегии поиска
3. По фактическому объёму поиска решите, нужно ли переходить на платный план
4. Командам с большим объёмом поиска — настройте несколько Provider для fallback

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

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