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

​
Tavily

OpenClaw може використовувати Tavily двома способами:
  • як провайдера web_search
  • як явні інструменти plugin-а: tavily_search і tavily_extract
Tavily — це API пошуку, створений для AI-застосунків, який повертає структуровані результати, оптимізовані для споживання LLM. Він підтримує налаштовувану глибину пошуку, фільтрацію за темою, фільтри доменів, згенеровані AI підсумки відповідей і витягування вмісту з URL (включно зі сторінками, відрендереними JavaScript).

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

  1. Створіть обліковий запис Tavily на tavily.com.
  2. Згенеруйте API-ключ у панелі керування.
  3. Збережіть його в config або встановіть TAVILY_API_KEY у середовищі gateway.

​
Налаштування пошуку Tavily

{
  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",
      },
    },
  },
}
Примітки:
  • Вибір Tavily в onboarding або через openclaw configure --section web автоматично вмикає вбудований plugin Tavily.
  • Зберігайте конфігурацію Tavily в plugins.entries.tavily.config.webSearch.*.
  • web_search із Tavily підтримує query і count (до 20 результатів).
  • Для специфічних для Tavily елементів керування, як-от search_depth, topic, include_answer або фільтри доменів, використовуйте tavily_search.

​
Інструменти plugin-а Tavily

Використовуйте це, якщо вам потрібні специфічні для Tavily елементи керування пошуком замість загального web_search.
ПараметрОпис
queryРядок пошукового запиту (не довше 400 символів)
search_depthbasic (типово, збалансовано) або advanced (найвища релевантність, повільніше)
topicgeneral (типово), news (оновлення в реальному часі) або finance
max_resultsКількість результатів, 1-20 (типово: 5)
include_answerДодати згенерований AI підсумок відповіді (типово: false)
time_rangeФільтр за давністю: day, week, month або year
include_domainsМасив доменів, якими обмежуються результати
exclude_domainsМасив доменів, які потрібно виключити з результатів
Глибина пошуку:
ГлибинаШвидкістьРелевантністьНайкраще підходить для
basicШвидшеВисокаЗапитів загального призначення (типово)
advancedПовільнішеНайвищаТочності, конкретних фактів, досліджень

​
tavily_extract

Використовуйте це, щоб витягувати чистий вміст з одного або кількох URL. Обробляє сторінки, відрендерені JavaScript, і підтримує chunking із фокусом на запиті для цільового витягування.
ПараметрОпис
urlsМасив URL для витягування (1-20 на запит)
queryПовторно ранжувати витягнуті chunks за релевантністю до цього запиту
extract_depthbasic (типово, швидко) або advanced (для сторінок із важким JS)
chunks_per_sourceChunks на URL, 1-5 (потребує query)
include_imagesДодавати URL зображень до результатів (типово: false)
Глибина витягування:
ГлибинаКоли використовувати
basicПрості сторінки - спочатку спробуйте це
advancedSPA, відрендерені JS, динамічний вміст, таблиці
Поради:
  • Максимум 20 URL на запит. Розбивайте більші списки на кілька викликів.
  • Використовуйте query + chunks_per_source, щоб отримати лише релевантний вміст замість повних сторінок.
  • Спочатку спробуйте basic; переходьте до advanced, якщо вміст відсутній або неповний.

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

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

​
Пов’язане

  • Огляд Web Search — усі провайдери та автовизначення
  • Firecrawl — пошук + scraping із витягуванням вмісту
  • Пошук Exa — neural search із витягуванням вмісту