Tavily

Tavily — это поисковый API, разработанный для приложений ИИ. OpenClaw предоставляет к нему доступ двумя способами:

как к провайдеру web_search для универсального инструмента поиска
как к отдельным инструментам плагина: tavily_search и tavily_extract

Tavily возвращает структурированные результаты, оптимизированные для обработки LLM, с настраиваемой глубиной поиска, фильтрацией по темам и доменам, сводками ответов, созданными ИИ, и извлечением содержимого из URL-адресов (включая страницы, отрисовываемые с помощью JavaScript).

Свойство	Значение
ID плагина	`tavily`
Пакет	`@openclaw/tavily-plugin`
Аутентификация	переменная среды `TAVILY_API_KEY` или параметр конфигурации `apiKey`
Базовый URL	`https://api.tavily.com` (по умолчанию); для переопределения используйте переменную среды `TAVILY_BASE_URL` или параметр конфигурации `baseUrl`
Тайм-ауты	30 с для поиска, 60 с для извлечения (по умолчанию)
Инструменты	`tavily_search`, `tavily_extract`

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

Установите плагин

openclaw plugins install @openclaw/tavily-plugin

Получите ключ API

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

Настройте плагин и провайдер

{
  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",
      },
    },
  },
}

Проверьте выполнение поиска

Запустите web_search из любого агента или вызовите tavily_search напрямую.

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

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

`tavily_search`

Используйте этот инструмент, если вместо универсального web_search вам нужны параметры поиска, специфичные для Tavily.

Параметр	Тип	Ограничения / значение по умолчанию	Описание
`query`	строка	обязателен	Строка поискового запроса.
`search_depth`	перечисление	`basic` (по умолчанию), `advanced`	`advanced` работает медленнее, но обеспечивает более высокую релевантность.
`topic`	перечисление	`general` (по умолчанию), `news`, `finance`	Фильтрация по категории темы.
`max_results`	целое число	1-20, по умолчанию `5`	Количество результатов.
`include_answer`	логический	по умолчанию `false`	Включить созданную ИИ Tavily сводку ответа.
`time_range`	перечисление	`day`, `week`, `month`, `year`	Фильтрация результатов по давности.
`include_domains`	массив строк	(нет)	Включать только результаты с этих доменов.
`exclude_domains`	массив строк	(нет)	Исключать результаты с этих доменов.

Компромисс при выборе глубины поиска:

Глубина	Скорость	Релевантность	Оптимальное применение
`basic`	Выше	Высокая	Запросы общего назначения (по умолчанию).
`advanced`	Ниже	Максимальная	Точные исследования и поиск фактов.

`tavily_extract`

Используйте этот инструмент для извлечения очищенного содержимого из одного или нескольких URL-адресов. Он обрабатывает страницы, отрисовываемые с помощью JavaScript, и поддерживает разбиение на фрагменты с учетом запроса для целевого извлечения.

Параметр	Тип	Ограничения / значение по умолчанию	Описание
`urls`	массив строк	обязателен, 1-20	URL-адреса, из которых нужно извлечь содержимое.
`query`	строка	(необязательно)	Повторно ранжировать извлеченные фрагменты по релевантности этому запросу.
`extract_depth`	перечисление	`basic` (по умолчанию), `advanced`	Используйте `advanced` для страниц с интенсивным использованием JS, SPA или динамических таблиц.
`chunks_per_source`	целое число	1-5; требуется `query`	Количество фрагментов, возвращаемых для каждого URL-адреса. Если параметр задан без `query`, возникает ошибка.
`include_images`	логический	по умолчанию `false`	Включить URL-адреса изображений в результаты.

Компромисс при выборе глубины извлечения:

Глубина	Когда использовать
`basic`	Простые страницы. Сначала попробуйте этот вариант.
`advanced`	SPA, отрисовываемые с помощью JS, динамическое содержимое и таблицы.

Разделяйте большие списки URL-адресов на несколько вызовов tavily_extract (не более 20 на запрос). Используйте query вместе с chunks_per_source, чтобы получать только релевантное содержимое вместо полных страниц.

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

Задача	Инструмент
Быстрый поиск в интернете без особых параметров	`web_search`
Поиск с настройкой глубины, темы и ответами ИИ	`tavily_search`
Извлечение содержимого из конкретных URL-адресов	`tavily_extract`

Универсальный инструмент web_search с Tavily в качестве провайдера поддерживает query и count (до 20 результатов). Для параметров, специфичных для Tavily (search_depth, topic, include_answer, фильтры доменов, временной диапазон), вместо него используйте tavily_search.

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

Порядок определения ключа API

Клиент Tavily ищет ключ API в следующем порядке:

plugins.entries.tavily.config.webSearch.apiKey (разрешается через SecretRefs).
TAVILY_API_KEY из среды Gateway.

Если ни одно из значений не задано, tavily_search и tavily_extract вызывают ошибку настройки.

Пользовательский базовый URL

Если доступ к Tavily осуществляется через прокси, переопределите plugins.entries.tavily.config.webSearch.baseUrl или задайте TAVILY_BASE_URL. Параметр конфигурации имеет приоритет над переменной среды. Значение по умолчанию — https://api.tavily.com.

Для `chunks_per_source` требуется `query`

tavily_extract отклоняет вызовы, в которых передан chunks_per_source без query. Tavily ранжирует фрагменты по релевантности запросу, поэтому без него этот параметр не имеет смысла.

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

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

Все провайдеры и правила автоматического обнаружения.

Firecrawl

Поиск и сбор данных с извлечением содержимого.

Поиск Exa

Нейронный поиск с извлечением содержимого.

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

Полная схема конфигурации записей плагинов и маршрутизации инструментов.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

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

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

`tavily_search`

`tavily_extract`

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

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

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

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

Firecrawl

Поиск Exa

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

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

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

​tavily_search

​tavily_extract

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

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

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

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

Firecrawl

Поиск Exa

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

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

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

`tavily_search`

`tavily_extract`

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

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

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