Tools
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_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, динамическое содержимое и таблицы. |
Выбор подходящего инструмента
| Задача | Инструмент |
|---|---|
| Быстрый поиск в интернете без особых параметров | web_search |
| Поиск с настройкой глубины, темы и ответами ИИ | tavily_search |
| Извлечение содержимого из конкретных URL-адресов | tavily_extract |
Расширенная конфигурация
Порядок определения ключа 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 ранжирует фрагменты по релевантности запросу, поэтому без него этот параметр не имеет смысла.
