Tavily

OpenClaw може використовувати Tavily двома способами:

• як провайдера web_search
• як явні інструменти Plugin: tavily_search і tavily_extract

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

# Отримання API key

1. Створіть обліковий запис Tavily на tavily.com.
2. Згенеруйте API key у панелі керування.
3. Збережіть його в конфігурації або встановіть 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_search

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

Параметр	Опис
query	Рядок пошукового запиту (тримайте в межах 400 символів)
search_depth	basic (типово, збалансовано) або advanced (найвища релевантність, повільніше)
topic	general (типово), news (оновлення в реальному часі) або finance
max_results	Кількість результатів, 1-20 (типово: 5)
include_answer	Включити AI-generated answer summary (типово: 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_depth	basic (типово, швидко) або advanced (для JS-heavy pages)
chunks_per_source	Chunks на URL, 1-5 (потребує query)
include_images	Включати URL-адреси зображень у результати (типово: false)

Глибина витягування:

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

Поради:

• Максимум 20 URL-адрес на запит. Великі списки розбивайте на кілька викликів.
• Використовуйте query + chunks_per_source, щоб отримувати лише релевантний вміст замість повних сторінок.
• Спочатку пробуйте basic; переходьте на advanced, якщо вміст відсутній або неповний.

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

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

# Пов’язане

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