Przejdź do głównej treści
Tavily to API wyszukiwania zaprojektowane dla aplikacji AI. OpenClaw udostępnia je na dwa sposoby:
  • jako dostawcę web_search dla ogólnego narzędzia wyszukiwania
  • jako jawne narzędzia Plugin: tavily_search i tavily_extract
Tavily zwraca wyniki strukturalne zoptymalizowane pod kątem użycia przez LLM, z konfigurowalną głębokością wyszukiwania, filtrowaniem tematów, filtrami domen, wygenerowanymi przez AI podsumowaniami odpowiedzi oraz ekstrakcją treści z URL-i (w tym stron renderowanych przez JavaScript).
WłaściwośćWartość
Identyfikator Plugintavily
Pakiet@openclaw/tavily-plugin
UwierzytelnianieTAVILY_API_KEY lub config apiKey
Bazowy URLhttps://api.tavily.com (domyślnie)
Narzędziatavily_search, tavily_extract

​
Pierwsze kroki

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

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

Configure the plugin and provider

{
  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",
      },
    },
  },
}
4

Verify search runs

Wywołaj web_search z dowolnego agenta albo wywołaj bezpośrednio tavily_search.
Wybranie Tavily podczas onboardingu albo przez openclaw configure --section web instaluje i włącza oficjalny Tavily Plugin, gdy jest potrzebny.

​
Dokumentacja narzędzi

Użyj tego narzędzia, gdy potrzebujesz sterowania wyszukiwaniem specyficznego dla Tavily zamiast ogólnego web_search.
ParametrTypOgraniczenia / domyślnieOpis
querystringwymaganeTekst zapytania wyszukiwania. Nie przekraczaj 400 znaków.
search_depthenumbasic (domyślnie), advancedadvanced jest wolniejsze, ale daje większą trafność.
topicenumgeneral (domyślnie), news, financeFiltruj według rodziny tematów.
max_resultsinteger1-20Liczba wyników.
include_answerbooleandomyślnie falseDołącz wygenerowane przez AI podsumowanie odpowiedzi Tavily.
time_rangeenumday, week, month, yearFiltruj wyniki według świeżości.
include_domainsstring array(brak)Uwzględnij tylko wyniki z tych domen.
exclude_domainsstring array(brak)Wyklucz wyniki z tych domen.
Kompromis głębokości wyszukiwania:
GłębokośćSzybkośćTrafnośćNajlepsze do
basicSzybszeWysokaZapytania ogólnego przeznaczenia (domyślnie).
advancedWolniejszeNajwyższaPrecyzyjne badania i ustalanie faktów.

​
tavily_extract

Użyj tego narzędzia, aby wyodrębnić czystą treść z jednego lub wielu URL-i. Obsługuje strony renderowane przez JavaScript i wspiera porcjowanie ukierunkowane zapytaniem dla celowanej ekstrakcji.
ParametrTypOgraniczenia / domyślnieOpis
urlsstring arraywymagane, 1-20URL-e, z których należy wyodrębnić treść.
querystring(opcjonalne)Ponownie szereguj wyodrębnione fragmenty według trafności względem tego zapytania.
extract_depthenumbasic (domyślnie), advancedUżyj advanced dla stron intensywnie korzystających z JS, SPA lub dynamicznych tabel.
chunks_per_sourceinteger1-5; wymaga queryFragmenty zwracane na URL. Powoduje błąd, jeśli ustawione bez query.
include_imagesbooleandomyślnie falseDołącz URL-e obrazów w wynikach.
Kompromis głębokości ekstrakcji:
GłębokośćKiedy używać
basicProste strony. Wypróbuj najpierw to.
advancedSPA renderowane przez JS, dynamiczna treść, tabele.
Dziel większe listy URL-i na wiele wywołań tavily_extract (maks. 20 na żądanie). Użyj query wraz z chunks_per_source, aby uzyskać tylko istotną treść zamiast pełnych stron.

​
Wybór właściwego narzędzia

PotrzebaNarzędzie
Szybkie wyszukiwanie w sieci, bez specjalnych opcjiweb_search
Wyszukiwanie z głębokością, tematem, odpowiedziami AItavily_search
Ekstrakcja treści z konkretnych URL-itavily_extract
Ogólne narzędzie web_search z Tavily jako dostawcą obsługuje query i count (do 20 wyników). Aby użyć opcji specyficznych dla Tavily (search_depth, topic, include_answer, filtry domen, zakres czasu), użyj zamiast tego tavily_search.

​
Zaawansowana konfiguracja

Klient Tavily wyszukuje swój klucz API w tej kolejności:
  1. plugins.entries.tavily.config.webSearch.apiKey (rozwiązywane przez SecretRefs).
  2. TAVILY_API_KEY ze środowiska Gateway.
tavily_extract zgłasza błąd konfiguracji, jeśli żadne z nich nie jest obecne.
Nadpisz plugins.entries.tavily.config.webSearch.baseUrl, jeśli udostępniasz Tavily przez proxy. Wartość domyślna to https://api.tavily.com.
tavily_extract odrzuca wywołania, które przekazują chunks_per_source bez query. Tavily klasyfikuje fragmenty według trafności zapytania, więc bez niego parametr nie ma znaczenia.

​
Powiązane

Web Search overview

Wszyscy dostawcy i reguły automatycznego wykrywania.

Firecrawl

Wyszukiwanie plus scraping z ekstrakcją treści.

Exa Search

Wyszukiwanie neuronowe z ekstrakcją treści.

Configuration

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