Naar hoofdinhoud gaan
Tavily is een zoek-API die is ontworpen voor AI-toepassingen. OpenClaw biedt deze op twee manieren aan:
  • 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 gebruik door LLM’s, met configureerbare zoekdiepte, onderwerpfiltering, domeinfilters, door AI gegenereerde antwoordsamenvattingen en contentextractie uit URL’s (inclusief door JavaScript gerenderde pagina’s).
EigenschapWaarde
Plugin-idtavily
Pakket@openclaw/tavily-plugin
AuthTAVILY_API_KEY of config apiKey
Basis-URLhttps://api.tavily.com (standaard)
Toolstavily_search, tavily_extract

​
Aan de slag

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

Maak een Tavily-account aan op tavily.com en genereer daarna een API-sleutel in het dashboard.
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

Start een web_search vanuit een agent, of roep tavily_search rechtstreeks aan.
Als je Tavily kiest tijdens onboarding of via openclaw configure --section web, wordt de officiële Tavily-Plugin geïnstalleerd en ingeschakeld wanneer dat nodig is.

​
Toolreferentie

Gebruik dit wanneer je Tavily-specifieke zoekinstellingen wilt in plaats van de generieke web_search.
ParameterTypeBeperkingen / standaardwaardeBeschrijving
querystringvereistZoekquerystring. 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 queries (standaard).
advancedLangzamerHoogstNauwkeurig onderzoek en feitenonderzoek.

​
tavily_extract

Gebruik dit om schone content uit een of meer URL’s te extraheren. Verwerkt door JavaScript gerenderde pagina’s en ondersteunt querygerichte chunking voor gerichte extractie.
ParameterTypeBeperkingen / standaardwaardeBeschrijving
urlsstring arrayvereist, 1-20URL’s waaruit content moet worden geëxtraheerd.
querystring(optioneel)Rangschik geëxtraheerde chunks opnieuw op relevantie voor deze query.
extract_depthenumbasic (standaard), advancedGebruik advanced voor JS-intensieve pagina’s, SPA’s of dynamische tabellen.
chunks_per_sourceinteger1-5; vereist queryChunks die per URL worden geretourneerd. Geeft een fout als dit zonder query is ingesteld.
include_imagesbooleanstandaard falseNeem afbeeldings-URL’s op in resultaten.
Afweging bij extractiediepte:
DiepteWanneer te gebruiken
basicEenvoudige pagina’s. Probeer dit eerst.
advancedDoor JS gerenderde SPA’s, dynamische content, tabellen.
Verdeel grotere URL-lijsten over meerdere tavily_extract-aanroepen (maximaal 20 per request). Gebruik query plus chunks_per_source om alleen relevante content 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
Content extraheren uit specifieke URL’stavily_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, tijdbereik) in plaats daarvan tavily_search.

​
Geavanceerde configuratie

De Tavily-client zoekt zijn 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 installatiefout als geen van beide aanwezig is.
Overschrijf plugins.entries.tavily.config.webSearch.baseUrl als je Tavily via een proxy laat lopen. 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 zonder query betekenisloos.

​
Gerelateerd

Web Search overview

Alle providers en regels voor automatische detectie.

Firecrawl

Zoeken plus scraping met contentextractie.

Exa Search

Neuraal zoeken met contentextractie.

Configuration

Volledig configschema voor Plugin-vermeldingen en toolroutering.