---
read_when:
- Вам потрібен вебпошук на базі Tavily
- Вам потрібен API-ключ Tavily
- Вам потрібен Tavily як провайдер web_search
- Вам потрібне вилучення вмісту з URL-адрес
summary: Інструменти пошуку та вилучення Tavily
title: Tavily
x-i18n:
generated_at: "2026-05-11T21:02:52Z"
model: gpt-5.5
provider: openai
source_hash: 071e2b1be054890711e32d7424d16d94133d16ff1ce7da3703e62c53b5c217ef
source_path: tools/tavily.md
workflow: 16
---
[Tavily](https://tavily.com) — це пошуковий API, розроблений для AI-застосунків. OpenClaw надає його двома способами:
- як провайдер `web_search` для загального інструмента пошуку
- як явні інструменти Plugin: `tavily_search` і `tavily_extract`
Tavily повертає структуровані результати, оптимізовані для споживання LLM, із налаштовуваною глибиною пошуку, фільтрацією за темами, фільтрами доменів, AI-згенерованими підсумками відповідей і витягуванням вмісту з URL-адрес (зокрема сторінок, відрендерених JavaScript).
| Властивість | Значення |
| ------------- | ----------------------------------- |
| ID Plugin | `tavily` |
| Автентифікація | `TAVILY_API_KEY` або config `apiKey` |
| Базова URL-адреса | `https://api.tavily.com` (за замовчуванням) |
| Вбудовані інструменти | `tavily_search`, `tavily_extract` |
## Початок роботи
Створіть обліковий запис Tavily на [tavily.com](https://tavily.com), а потім згенеруйте API-ключ на панелі керування.
```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",
},
},
},
}
```
Запустіть `web_search` з будь-якого агента або викличте `tavily_search` напряму.
Вибір Tavily під час онбордингу або `openclaw configure --section web` автоматично вмикає вбудований Tavily Plugin.
## Довідник інструментів
### `tavily_search`
Використовуйте це, коли потрібні специфічні для Tavily елементи керування пошуком замість загального `web_search`.
| Параметр | Тип | Обмеження / значення за замовчуванням | Опис |
| ----------------- | ------------ | -------------------------------------- | ----------------------------------------------- |
| `query` | string | обов’язково | Рядок пошукового запиту. Не більше 400 символів. |
| `search_depth` | enum | `basic` (за замовчуванням), `advanced` | `advanced` повільніший, але має вищу релевантність. |
| `topic` | enum | `general` (за замовчуванням), `news`, `finance` | Фільтрація за тематичною групою. |
| `max_results` | integer | 1-20 | Кількість результатів. |
| `include_answer` | boolean | за замовчуванням `false` | Додати AI-згенерований Tavily підсумок відповіді. |
| `time_range` | enum | `day`, `week`, `month`, `year` | Фільтрувати результати за давністю. |
| `include_domains` | string array | (немає) | Додавати лише результати з цих доменів. |
| `exclude_domains` | string array | (немає) | Виключати результати з цих доменів. |
Компроміс глибини пошуку:
| Глибина | Швидкість | Релевантність | Найкраще для |
| ---------- | ------ | --------- | ------------------------------------ |
| `basic` | Швидше | Висока | Запити загального призначення (за замовчуванням). |
| `advanced` | Повільніше | Найвища | Точні дослідження й пошук фактів. |
### `tavily_extract`
Використовуйте це, щоб витягувати чистий вміст з однієї або кількох URL-адрес. Обробляє сторінки, відрендерені JavaScript, і підтримує орієнтоване на запит розбиття на фрагменти для цільового витягування.
| Параметр | Тип | Обмеження / значення за замовчуванням | Опис |
| ------------------- | ------------ | ----------------------------- | ----------------------------------------------------------- |
| `urls` | string array | обов’язково, 1-20 | URL-адреси, з яких потрібно витягнути вміст. |
| `query` | string | (необов’язково) | Повторно ранжувати витягнуті фрагменти за релевантністю до цього запиту. |
| `extract_depth` | enum | `basic` (за замовчуванням), `advanced` | Використовуйте `advanced` для JS-насичених сторінок, SPA або динамічних таблиць. |
| `chunks_per_source` | integer | 1-5; **потребує `query`** | Фрагменти, що повертаються на кожну URL-адресу. Помилка, якщо задано без `query`. |
| `include_images` | boolean | за замовчуванням `false` | Додати URL-адреси зображень у результати. |
Компроміс глибини витягування:
| Глибина | Коли використовувати |
| ---------- | ------------------------------------------ |
| `basic` | Прості сторінки. Спробуйте це спершу. |
| `advanced` | SPA, відрендерені 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 ранжує фрагменти за релевантністю до запиту, тому без нього цей параметр не має сенсу.
## Пов’язане
Усі провайдери та правила автовиявлення.
Пошук і скрейпінг із витягуванням вмісту.
Нейронний пошук із витягуванням вмісту.
Повна схема конфігурації для записів Plugin і маршрутизації інструментів.