Tools

Tavily

Tavily — це пошуковий API, розроблений для AI-застосунків. OpenClaw надає його двома способами:

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

Tavily повертає структуровані результати, оптимізовані для споживання LLM, із налаштовуваною глибиною пошуку, фільтрацією за темами, фільтрами доменів, AI-згенерованими підсумками відповідей і витягуванням вмісту з URL-адрес (зокрема сторінок, відрендерених JavaScript).

Властивість	Значення
ID Plugin	`tavily`
Автентифікація	`TAVILY_API_KEY` або config `apiKey`
Базова URL-адреса	`https://api.tavily.com` (за замовчуванням)
Вбудовані інструменти	`tavily_search`, `tavily_extract`

Початок роботи

Отримайте API-ключ

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

Налаштуйте Plugin і провайдера

json5

{  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`

Використовуйте це, коли потрібні специфічні для Tavily елементи керування пошуком замість загального web_search.

Параметр	Тип	Обмеження / значення за замовчуванням	Опис
`query`	string	обов’язково	Рядок пошукового запиту. Не більше 400 символів.
`search_depth`	enum	`basic` (за замовчуванням), `advanced`	`advanced` повільніший, але має вищу релевантність.
`topic`	enum	`general` (за замовчуванням), `news`, `finance`	Фільтрація за тематичною групою.
`max_results`	integer	1-20	Кількість результатів.
`include_answer`	boolean	за замовчуванням `false`	Додати AI-згенерований Tavily підсумок відповіді.
`time_range`	enum	`day`, `week`, `month`, `year`	Фільтрувати результати за давністю.
`include_domains`	string array	(немає)	Додавати лише результати з цих доменів.
`exclude_domains`	string array	(немає)	Виключати результати з цих доменів.

Компроміс глибини пошуку:

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

`tavily_extract`

Використовуйте це, щоб витягувати чистий вміст з однієї або кількох URL-адрес. Обробляє сторінки, відрендерені JavaScript, і підтримує орієнтоване на запит розбиття на фрагменти для цільового витягування.

Параметр	Тип	Обмеження / значення за замовчуванням	Опис
`urls`	string array	обов’язково, 1-20	URL-адреси, з яких потрібно витягнути вміст.
`query`	string	(необов’язково)	Повторно ранжувати витягнуті фрагменти за релевантністю до цього запиту.
`extract_depth`	enum	`basic` (за замовчуванням), `advanced`	Використовуйте `advanced` для JS-насичених сторінок, SPA або динамічних таблиць.
`chunks_per_source`	integer	1-5; потребує `query`	Фрагменти, що повертаються на кожну URL-адресу. Помилка, якщо задано без `query`.
`include_images`	boolean	за замовчуванням `false`	Додати URL-адреси зображень у результати.

Компроміс глибини витягування:

Глибина	Коли використовувати
`basic`	Прості сторінки. Спробуйте це спершу.
`advanced`	SPA, відрендерені JS, динамічний вміст, таблиці.

Вибір правильного інструмента

Потреба	Інструмент
Швидкий вебпошук без спеціальних параметрів	`web_search`
Пошук із глибиною, темою, AI-відповідями	`tavily_search`
Витягування вмісту з конкретних URL-адрес	`tavily_extract`

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

Порядок визначення API-ключа

Клієнт Tavily шукає свій API-ключ у такому порядку:

plugins.entries.tavily.config.webSearch.apiKey (визначається через SecretRefs).
TAVILY_API_KEY із середовища Gateway.

tavily_extract спричиняє помилку налаштування, якщо немає жодного з них.

Користувацька базова URL-адреса

Перевизначте plugins.entries.tavily.config.webSearch.baseUrl, якщо ви проксируєте Tavily. Значення за замовчуванням — https://api.tavily.com.

`chunks_per_source` потребує `query`

tavily_extract відхиляє виклики, що передають chunks_per_source без query. Tavily ранжує фрагменти за релевантністю до запиту, тому без нього цей параметр не має сенсу.

Пов’язане

Огляд Web Search

Усі провайдери та правила автовиявлення.

Firecrawl

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

Exa Search

Нейронний пошук із витягуванням вмісту.

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

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

Was this useful?