Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tavily is een zoek-API ontworpen voor AI-toepassingen. OpenClaw stelt deze op twee manieren beschikbaar:
  • als de web_search-provider voor de generieke zoektool
  • als expliciete Plugin-tools: tavily_search en tavily_extract
Tavily retourneert gestructureerde resultaten die zijn geoptimaliseerd voor LLM-gebruik, met configureerbare zoekdiepte, onderwerpfiltering, domeinfilters, door AI gegenereerde antwoordsamenvattingen en inhoudsextractie uit URL’s (inclusief door JavaScript gerenderde pagina’s).
EigenschapWaarde
Plugin-idtavily
AuthTAVILY_API_KEY of config apiKey
Basis-URLhttps://api.tavily.com (standaard)
Gebundelde toolstavily_search, tavily_extract

​
Aan de slag

1

Een API-sleutel verkrijgen

Maak een Tavily-account aan op tavily.com en genereer vervolgens een API-sleutel in het dashboard.
2

De Plugin en provider configureren

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

Controleren of zoeken werkt

Activeer een web_search vanuit een willekeurige agent, of roep tavily_search rechtstreeks aan.
Als je Tavily kiest tijdens onboarding of via openclaw configure --section web, wordt de gebundelde Tavily-Plugin automatisch ingeschakeld.

​
Toolreferentie

Gebruik dit wanneer je Tavily-specifieke zoekinstellingen wilt in plaats van generieke web_search.
ParameterTypeBeperkingen / standaardBeschrijving
querystringvereistZoekquerytekenreeks. Houd deze onder 400 tekens.
search_depthenumbasic (standaard), advancedadvanced is langzamer, maar relevanter.
topicenumgeneral (standaard), news, financeFilter op onderwerpfamilie.
max_resultsinteger1-20Aantal resultaten.
include_answerbooleanstandaard falseVoeg een door Tavily AI gegenereerde antwoordsamenvatting toe.
time_rangeenumday, week, month, yearFilter resultaten op recentheid.
include_domainsstring array(geen)Neem alleen resultaten van deze domeinen op.
exclude_domainsstring array(geen)Sluit resultaten van deze domeinen uit.
Afweging bij zoekdiepte:
DiepteSnelheidRelevantieBeste voor
basicSnellerHoogAlgemene query’s (standaard).
advancedLangzamerHoogstPrecisieonderzoek en feitenonderzoek.

​
tavily_extract

Gebruik dit om schone inhoud uit een of meer URL’s te extraheren. Verwerkt door JavaScript gerenderde pagina’s en ondersteunt querygerichte chunking voor gerichte extractie.
ParameterTypeBeperkingen / standaardBeschrijving
urlsstring arrayvereist, 1-20URL’s waaruit inhoud moet worden geëxtraheerd.
querystring(optioneel)Herorden geëxtraheerde chunks op relevantie voor deze query.
extract_depthenumbasic (standaard), advancedGebruik advanced voor JS-zware pagina’s, SPA’s of dynamische tabellen.
chunks_per_sourceinteger1-5; vereist queryGeretourneerde chunks per URL. Geeft fouten als dit zonder query is ingesteld.
include_imagesbooleanstandaard falseNeem afbeeldings-URL’s op in resultaten.
Afweging bij extractiediepte:
DiepteWanneer gebruiken
basicEenvoudige pagina’s. Probeer dit eerst.
advancedDoor JS gerenderde SPA’s, dynamische inhoud, tabellen.
Splits grotere URL-lijsten op in meerdere tavily_extract-aanroepen (maximaal 20 per verzoek). Gebruik query plus chunks_per_source om alleen relevante inhoud te krijgen in plaats van volledige pagina’s.

​
De juiste tool kiezen

BehoefteTool
Snelle webzoekopdracht, geen speciale optiesweb_search
Zoeken met diepte, onderwerp, AI-antwoordentavily_search
Inhoud uit specifieke URL’s extraherentavily_extract
De generieke web_search-tool met Tavily als provider ondersteunt query en count (tot 20 resultaten). Gebruik voor Tavily-specifieke instellingen (search_depth, topic, include_answer, domeinfilters, tijdsbereik) in plaats daarvan tavily_search.

​
Geavanceerde configuratie

De Tavily-client zoekt de API-sleutel in deze volgorde op:
  1. plugins.entries.tavily.config.webSearch.apiKey (opgelost via SecretRefs).
  2. TAVILY_API_KEY uit de Gateway-omgeving.
tavily_extract geeft een configuratiefout als geen van beide aanwezig is.
Overschrijf plugins.entries.tavily.config.webSearch.baseUrl als je Tavily via een proxy aanbiedt. De standaardwaarde is https://api.tavily.com.
tavily_extract weigert aanroepen die chunks_per_source doorgeven zonder een query. Tavily rangschikt chunks op queryrelevantie, dus de parameter is betekenisloos zonder query.

​
Gerelateerd

Overzicht van Web Search

Alle providers en regels voor automatische detectie.

Firecrawl

Zoeken plus scraping met inhoudsextractie.

Exa Search

Neuraal zoeken met inhoudsextractie.

Configuratie

Volledig configuratieschema voor Plugin-vermeldingen en toolroutering.