---
read_when:
    - Ви хочете вебпошук на базі Tavily
    - Вам потрібен API-ключ Tavily
    - Ви хочете використовувати Tavily як провайдера `web_search`
    - Ви хочете витягувати вміст з URL
summary: Інструменти пошуку та витягування Tavily
title: Tavily
x-i18n:
    generated_at: "2026-04-05T18:21:08Z"
    model: gpt-5.4
    provider: openai
    source_hash: db530cc101dc930611e4ca54e3d5972140f116bfe168adc939dc5752322d205e
    source_path: tools/tavily.md
    workflow: 15
---

# Tavily

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

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

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

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

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

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

```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",
      },
    },
  },
}
```

Примітки:

- Вибір 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 підсумок відповіді (типово: 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) |
| `chunks_per_source` | Chunks на URL, 1-5 (потребує `query`)                       |
| `include_images`   | Додавати URL зображень до результатів (типово: false)        |

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

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

Поради:

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

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

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

## Пов’язане

- [Огляд Web Search](/tools/web) -- усі провайдери та автовизначення
- [Firecrawl](/tools/firecrawl) -- пошук + scraping із витягуванням вмісту
- [Пошук Exa](/tools/exa-search) -- neural search із витягуванням вмісту
