Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tavily — це пошуковий API, розроблений для AI-застосунків. OpenClaw надає його двома способами:
  • як провайдер web_search для загального інструмента пошуку
  • як явні інструменти Plugin: tavily_search і tavily_extract
Tavily повертає структуровані результати, оптимізовані для споживання LLM, із налаштовуваною глибиною пошуку, фільтрацією за темами, фільтрами доменів, AI-згенерованими підсумками відповідей і витягуванням вмісту з URL-адрес (зокрема сторінок, відрендерених JavaScript).
ВластивістьЗначення
ID Plugintavily
АвтентифікаціяTAVILY_API_KEY або config apiKey
Базова URL-адресаhttps://api.tavily.com (за замовчуванням)
Вбудовані інструментиtavily_search, tavily_extract

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

1

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

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

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

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

Перевірте, що пошук запускається

Запустіть 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
Витягування вмісту з конкретних URL-адресtavily_extract
Загальний інструмент web_search із Tavily як провайдером підтримує 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

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

Firecrawl

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

Exa Search

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

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

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