Tavily

Tavily to interfejs API wyszukiwania zaprojektowany dla aplikacji AI. OpenClaw udostępnia go na dwa sposoby:

jako dostawcę web_search dla ogólnego narzędzia wyszukiwania
jako jawne narzędzia pluginu: tavily_search i tavily_extract

Tavily zwraca ustrukturyzowane wyniki zoptymalizowane pod kątem wykorzystania przez modele LLM, z konfigurowalną głębokością wyszukiwania, filtrowaniem tematów i domen, generowanymi przez AI podsumowaniami odpowiedzi oraz wyodrębnianiem treści z adresów URL (w tym ze stron renderowanych przy użyciu JavaScriptu).

Właściwość	Wartość
Identyfikator pluginu	`tavily`
Pakiet	`@openclaw/tavily-plugin`
Uwierzytelnianie	zmienna środowiskowa `TAVILY_API_KEY` lub ustawienie `apiKey`
Bazowy adres URL	`https://api.tavily.com` (domyślnie); zmienna środowiskowa `TAVILY_BASE_URL` lub ustawienie `baseUrl`, aby go zastąpić
Limity czasu	30 s dla wyszukiwania, 60 s dla wyodrębniania (domyślnie)
Narzędzia	`tavily_search`, `tavily_extract`

Pierwsze kroki

Zainstaluj plugin

openclaw plugins install @openclaw/tavily-plugin

Uzyskaj klucz API

Utwórz konto Tavily na stronie tavily.com, a następnie wygeneruj klucz API w panelu.

Skonfiguruj plugin i dostawcę

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // opcjonalne, jeśli ustawiono TAVILY_API_KEY
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

Sprawdź działanie wyszukiwania

Uruchom web_search z dowolnego agenta lub wywołaj bezpośrednio tavily_search.

Wybranie Tavily podczas wdrażania lub w poleceniu openclaw configure --section web instaluje i włącza oficjalny plugin Tavily, gdy jest potrzebny.

Dokumentacja narzędzi

`tavily_search`

Użyj tego narzędzia, gdy potrzebujesz ustawień wyszukiwania specyficznych dla Tavily zamiast ogólnego narzędzia web_search.

Parametr	Typ	Ograniczenia / wartość domyślna	Opis
`query`	ciąg znaków	wymagany	Ciąg zapytania wyszukiwania.
`search_depth`	wyliczenie	`basic` (domyślnie), `advanced`	`advanced` działa wolniej, ale zapewnia większą trafność.
`topic`	wyliczenie	`general` (domyślnie), `news`, `finance`	Filtrowanie według kategorii tematycznej.
`max_results`	liczba całkowita	1–20, domyślnie `5`	Liczba wyników.
`include_answer`	wartość logiczna	domyślnie `false`	Dołącza wygenerowane przez AI Tavily podsumowanie odpowiedzi.
`time_range`	wyliczenie	`day`, `week`, `month`, `year`	Filtrowanie wyników według aktualności.
`include_domains`	tablica ciągów znaków	(brak)	Uwzględnia tylko wyniki z tych domen.
`exclude_domains`	tablica ciągów znaków	(brak)	Wyklucza wyniki z tych domen.

Kompromis dotyczący głębokości wyszukiwania:

Głębokość	Szybkość	Trafność	Najlepsze zastosowanie
`basic`	Większa	Wysoka	Zapytania ogólnego przeznaczenia (domyślnie).
`advanced`	Mniejsza	Najwyższa	Precyzyjne badania i wyszukiwanie informacji.

`tavily_extract`

Użyj tego narzędzia, aby wyodrębnić uporządkowaną treść z jednego lub wielu adresów URL. Obsługuje strony renderowane przy użyciu JavaScriptu i dzielenie treści na fragmenty ukierunkowane na zapytanie, co umożliwia precyzyjne wyodrębnianie.

Parametr	Typ	Ograniczenia / wartość domyślna	Opis
`urls`	tablica ciągów znaków	wymagany, 1–20	Adresy URL, z których ma zostać wyodrębniona treść.
`query`	ciąg znaków	(opcjonalny)	Ponownie porządkuje wyodrębnione fragmenty według trafności względem tego zapytania.
`extract_depth`	wyliczenie	`basic` (domyślnie), `advanced`	Użyj `advanced` w przypadku stron intensywnie korzystających z JS, aplikacji SPA lub dynamicznych tabel.
`chunks_per_source`	liczba całkowita	1–5; wymaga `query`	Liczba fragmentów zwracanych dla każdego adresu URL. Ustawienie bez `query` powoduje błąd.
`include_images`	wartość logiczna	domyślnie `false`	Dołącza adresy URL obrazów do wyników.

Kompromis dotyczący głębokości wyodrębniania:

Głębokość	Kiedy używać
`basic`	Proste strony. Wypróbuj tę opcję najpierw.
`advanced`	Aplikacje SPA renderowane przy użyciu JS, treści dynamiczne, tabele.

Dziel większe listy adresów URL na wiele wywołań tavily_extract (maksymalnie 20 na żądanie). Użyj query wraz z chunks_per_source, aby uzyskać tylko odpowiednią treść zamiast całych stron.

Wybór odpowiedniego narzędzia

Potrzeba	Narzędzie
Szybkie wyszukiwanie w internecie bez opcji specjalnych	`web_search`
Wyszukiwanie z określeniem głębokości, tematu i odpowiedziami AI	`tavily_search`
Wyodrębnianie treści z określonych adresów URL	`tavily_extract`

Ogólne narzędzie web_search z Tavily jako dostawcą obsługuje parametry query i count (do 20 wyników). Aby skorzystać z ustawień specyficznych dla Tavily (search_depth, topic, include_answer, filtrów domen i zakresu czasu), użyj zamiast niego tavily_search.

Konfiguracja zaawansowana

Kolejność rozpoznawania klucza API

Klient Tavily wyszukuje klucz API w następującej kolejności:

plugins.entries.tavily.config.webSearch.apiKey (rozpoznawany za pośrednictwem SecretRefs).
TAVILY_API_KEY ze środowiska Gateway.

Zarówno tavily_search, jak i tavily_extract zgłaszają błąd konfiguracji, jeśli żadna z tych wartości nie jest dostępna.

Niestandardowy bazowy adres URL

Jeśli korzystasz z Tavily za pośrednictwem serwera proxy, zastąp wartość plugins.entries.tavily.config.webSearch.baseUrl lub ustaw TAVILY_BASE_URL. Konfiguracja ma pierwszeństwo przed zmienną środowiskową. Wartość domyślna to https://api.tavily.com.

`chunks_per_source` wymaga `query`

tavily_extract odrzuca wywołania przekazujące chunks_per_source bez parametru query. Tavily szereguje fragmenty według trafności względem zapytania, dlatego bez niego ten parametr nie ma znaczenia.

Powiązane materiały

Omówienie wyszukiwania internetowego

Wszyscy dostawcy i reguły automatycznego wykrywania.

Firecrawl

Wyszukiwanie i pobieranie danych z wyodrębnianiem treści.

Wyszukiwanie Exa

Wyszukiwanie neuronowe z wyodrębnianiem treści.

Konfiguracja

Pełny schemat konfiguracji wpisów pluginów i routingu narzędzi.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Pierwsze kroki

Dokumentacja narzędzi

`tavily_search`

`tavily_extract`

Wybór odpowiedniego narzędzia

Konfiguracja zaawansowana

Powiązane materiały

Omówienie wyszukiwania internetowego

Firecrawl

Wyszukiwanie Exa

Konfiguracja

​Pierwsze kroki

​Dokumentacja narzędzi

​tavily_search

​tavily_extract

​Wybór odpowiedniego narzędzia

​Konfiguracja zaawansowana

​Powiązane materiały

Omówienie wyszukiwania internetowego

Firecrawl

Wyszukiwanie Exa

Konfiguracja

Pierwsze kroki

Dokumentacja narzędzi

`tavily_search`

`tavily_extract`

Wybór odpowiedniego narzędzia

Konfiguracja zaawansowana

Powiązane materiały