Перейти к основному содержанию
Tavily — это поисковый API, созданный для AI-приложений. OpenClaw предоставляет его двумя способами:
  • как provider web_search для общего инструмента поиска
  • как явные инструменты Plugin: tavily_search и tavily_extract
Tavily возвращает структурированные результаты, оптимизированные для потребления LLM, с настраиваемой глубиной поиска, фильтрацией по темам, фильтрами доменов, AI-сгенерированными сводками ответов и извлечением контента из URL-адресов (включая страницы, отрисованные JavaScript).
СвойствоЗначение
ID Plugintavily
Пакет@openclaw/tavily-plugin
AuthTAVILY_API_KEY или config apiKey
Базовый URLhttps://api.tavily.com (по умолчанию)
Инструментыtavily_search, tavily_extract

​
Начало работы

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

Создайте учетную запись Tavily на tavily.com, затем сгенерируйте API-ключ на панели управления.
3

Configure the plugin and provider

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
4

Verify search runs

Запустите web_search из любого агента или вызовите tavily_search напрямую.
Выбор Tavily при первичной настройке или через openclaw configure --section web устанавливает и включает официальный Tavily Plugin при необходимости.

​
Справочник инструментов

Используйте это, когда нужны специфичные для Tavily элементы управления поиском вместо общего web_search.
ПараметрТипОграничения / значение по умолчаниюОписание
querystringобязательноСтрока поискового запроса. Не более 400 символов.
search_depthenumbasic (по умолчанию), advancedadvanced медленнее, но дает более высокую релевантность.
topicenumgeneral (по умолчанию), news, financeФильтрация по семейству тем.
max_resultsinteger1-20Количество результатов.
include_answerbooleanпо умолчанию falseВключить AI-сгенерированную сводку ответа Tavily.
time_rangeenumday, week, month, yearФильтровать результаты по давности.
include_domainsstring array(нет)Включать результаты только с этих доменов.
exclude_domainsstring array(нет)Исключать результаты с этих доменов.
Компромисс глубины поиска:
ГлубинаСкоростьРелевантностьЛучше всего для
basicБыстрееВысокаяЗапросы общего назначения (по умолчанию).
advancedМедленнееСамая высокаяТочные исследования и поиск фактов.

​
tavily_extract

Используйте это для извлечения чистого контента из одного или нескольких URL-адресов. Обрабатывает страницы, отрисованные JavaScript, и поддерживает разбиение на фрагменты с учетом запроса для целевого извлечения.
ПараметрТипОграничения / значение по умолчаниюОписание
urlsstring arrayобязательно, 1-20URL-адреса, из которых нужно извлечь контент.
querystring(необязательно)Повторно ранжировать извлеченные фрагменты по релевантности этому запросу.
extract_depthenumbasic (по умолчанию), advancedИспользуйте advanced для страниц с большим объемом JS, SPA или динамических таблиц.
chunks_per_sourceinteger1-5; требует queryФрагменты, возвращаемые для каждого URL. Выдает ошибку, если задано без query.
include_imagesbooleanпо умолчанию falseВключить URL-адреса изображений в результаты.
Компромисс глубины извлечения:
ГлубинаКогда использовать
basicПростые страницы. Попробуйте сначала это.
advancedSPA, отрисованные JS, динамический контент, таблицы.
Разбивайте большие списки URL на несколько вызовов tavily_extract (максимум 20 за запрос). Используйте query вместе с chunks_per_source, чтобы получать только релевантный контент вместо полных страниц.

​
Выбор подходящего инструмента

ПотребностьИнструмент
Быстрый веб-поиск без специальных параметровweb_search
Поиск с глубиной, темой и AI-ответамиtavily_search
Извлечение контента из конкретных URLtavily_extract
Общий инструмент web_search с Tavily в качестве provider поддерживает query и count (до 20 результатов). Для специфичных для Tavily элементов управления (search_depth, topic, include_answer, фильтры доменов, диапазон времени) используйте вместо него tavily_search.

​
Расширенная конфигурация

Клиент Tavily ищет свой API-ключ в таком порядке:
  1. plugins.entries.tavily.config.webSearch.apiKey (разрешается через SecretRefs).
  2. TAVILY_API_KEY из окружения Gateway.
tavily_extract выдает ошибку настройки, если отсутствуют оба значения.
Переопределите plugins.entries.tavily.config.webSearch.baseUrl, если вы проксируете Tavily. Значение по умолчанию — https://api.tavily.com.
tavily_extract отклоняет вызовы, которые передают chunks_per_source без query. Tavily ранжирует фрагменты по релевантности запросу, поэтому без него параметр не имеет смысла.

​
Связанные материалы

Web Search overview

Все providers и правила автообнаружения.

Firecrawl

Поиск плюс scraping с извлечением контента.

Exa Search

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

Configuration

Полная схема config для записей Plugin и маршрутизации инструментов.