OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Tavily

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 algemene zoektool
  • als expliciete plugintools: tavily_search en tavily_extract

Tavily retourneert gestructureerde resultaten die zijn geoptimaliseerd voor verwerking door LLM's, met configureerbare zoekdiepte, onderwerpfiltering, domeinfilters, door AI gegenereerde antwoordsamenvattingen en inhoudsextractie uit URL's (inclusief pagina's die met JavaScript worden gerenderd).

Eigenschap Waarde
Plugin-id tavily
Pakket @openclaw/tavily-plugin
Authenticatie omgevingsvariabele TAVILY_API_KEY of configuratieoptie apiKey
Basis-URL https://api.tavily.com (standaard); omgevingsvariabele TAVILY_BASE_URL of configuratieoptie baseUrl om deze te overschrijven
Time-outs 30 s voor zoeken, 60 s voor extractie (standaard)
Tools tavily_search, tavily_extract

Aan de slag

  • Installeer de plugin

    bash
    openclaw plugins install @openclaw/tavily-plugin

  • Verkrijg een API-sleutel

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

  • Configureer de plugin en provider

    json5
    {  plugins: {    entries: {      tavily: {        enabled: true,        config: {          webSearch: {            apiKey: "tvly-...", // optioneel als TAVILY_API_KEY is ingesteld            baseUrl: "https://api.tavily.com",          },        },      },    },  },  tools: {    web: {      search: {        provider: "tavily",      },    },  },}

  • Controleer of zoekopdrachten worden uitgevoerd

    Activeer een web_search vanuit een willekeurige agent of roep tavily_search rechtstreeks aan.

    • Toolreferentie

    Gebruik dit wanneer je Tavily-specifieke zoekinstellingen wilt gebruiken in plaats van de algemene web_search.

    Parameter Type Beperkingen / standaardwaarde Beschrijving
    query tekenreeks vereist Tekenreeks voor de zoekopdracht.
    search_depth enum basic (standaard), advanced advanced is langzamer, maar relevanter.
    topic enum general (standaard), news, finance Filter op onderwerpcategorie.
    max_results geheel getal 1-20, standaard 5 Aantal resultaten.
    include_answer booleaans standaard false Voeg een door Tavily AI gegenereerde antwoordsamenvatting toe.
    time_range enum day, week, month, year Filter resultaten op actualiteit.
    include_domains tekenreeksmatrix (geen) Neem alleen resultaten uit deze domeinen op.
    exclude_domains tekenreeksmatrix (geen) Sluit resultaten uit deze domeinen uit.

    Afweging bij zoekdiepte:

    Diepte Snelheid Relevantie Het meest geschikt voor
    basic Sneller Hoog Algemene zoekopdrachten (standaard).
    advanced Langzamer Hoogst Nauwkeurig onderzoek en feitenonderzoek.

    tavily_extract

    Gebruik dit om opgeschoonde inhoud uit een of meer URL's te extraheren. Verwerkt pagina's die met JavaScript worden gerenderd en ondersteunt op zoekopdrachten gerichte segmentering voor doelgerichte extractie.

    Parameter Type Beperkingen / standaardwaarde Beschrijving
    urls tekenreeksmatrix vereist, 1-20 URL's waaruit inhoud moet worden geëxtraheerd.
    query tekenreeks (optioneel) Rangschik geëxtraheerde segmenten opnieuw op relevantie voor deze zoekopdracht.
    extract_depth enum basic (standaard), advanced Gebruik advanced voor pagina's met veel JS, SPA's of dynamische tabellen.
    chunks_per_source geheel getal 1-5; vereist query Aantal geretourneerde segmenten per URL. Geeft een fout als dit zonder query wordt ingesteld.
    include_images booleaans standaard false Neem afbeeldings-URL's op in de resultaten.

    Afweging bij extractiediepte:

    Diepte Wanneer te gebruiken
    basic Eenvoudige pagina's. Probeer dit eerst.
    advanced Met JS gerenderde SPA's, dynamische inhoud en tabellen.

    De juiste tool kiezen

    Behoefte Tool
    Snel zoeken op het web, zonder speciale opties web_search
    Zoeken met diepte, onderwerp en AI-antwoorden tavily_search
    Inhoud uit specifieke URL's extraheren tavily_extract

    Geavanceerde configuratie

    Volgorde voor het bepalen van de API-sleutel

    De Tavily-client zoekt in deze volgorde naar de API-sleutel:

    1. plugins.entries.tavily.config.webSearch.apiKey (opgelost via SecretRefs).
    2. TAVILY_API_KEY uit de Gateway-omgeving.

    Zowel tavily_search als tavily_extract geeft een configuratiefout als geen van beide aanwezig is.

    Aangepaste basis-URL

    Overschrijf plugins.entries.tavily.config.webSearch.baseUrl of stel TAVILY_BASE_URL in als je Tavily via een proxy ontsluit. De configuratie heeft voorrang op de omgevingsvariabele. De standaardwaarde is https://api.tavily.com.

    `chunks_per_source` vereist `query`

    tavily_extract weigert aanroepen die chunks_per_source doorgeven zonder een query. Tavily rangschikt segmenten op relevantie voor de zoekopdracht, waardoor de parameter zonder zoekopdracht geen betekenis heeft.

    Gerelateerd

    Overzicht van zoeken op het web

    Alle providers en regels voor automatische detectie.
    Firecrawl

    Zoeken en scrapen met inhoudsextractie.
    Exa Search

    Neuraal zoeken met inhoudsextractie.
    Configuratie

    Volledig configuratieschema voor pluginvermeldingen en toolroutering.
    Was this useful?
    On this page

    On this page