---
read_when:
    - Ви хочете web search на основі Tavily
    - Вам потрібен API key Tavily
    - Ви хочете використовувати Tavily як провайдера `web_search`
    - Ви хочете витягувати вміст з URL-адрес
summary: Інструменти пошуку та витягування Tavily
title: Tavily
x-i18n:
    generated_at: "2026-04-23T21:17:15Z"
    model: gpt-5.4
    provider: openai
    source_hash: 9af858cd8507e3ebe6614f0695f568ce589798c816c8475685526422a048ef1a
    source_path: tools/tavily.md
    workflow: 15
---

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](https://tavily.com/).
2. Згенеруйте API key у панелі керування.
3. Збережіть його в конфігурації або встановіть `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-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](/uk/tools/web) -- усі провайдери та автовиявлення
- [Firecrawl](/uk/tools/firecrawl) -- пошук + scraping з витягуванням вмісту
- [Пошук Exa](/uk/tools/exa-search) -- нейронний пошук із витягуванням вмісту
