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

​
Довідник інструментів

Використовуйте це, коли потрібні специфічні для 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 overview

Усі постачальники та правила автоматичного виявлення.

Firecrawl

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

Exa Search

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

Configuration

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