> ## 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
[Tavily](https://tavily.com) 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).
| Eigenschap | Waarde |
| ---------- | ------------------------------------ |
| Plugin-id | `tavily` |
| Pakket | `@openclaw/tavily-plugin` |
| Auth | `TAVILY_API_KEY` of config `apiKey` |
| Basis-URL | `https://api.tavily.com` (standaard) |
| Tools | `tavily_search`, `tavily_extract` |
## Aan de slag
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/tavily-plugin
```
Maak een Tavily-account aan op [tavily.com](https://tavily.com) en genereer daarna een API-sleutel in het dashboard.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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",
},
},
},
}
```
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
### `tavily_search`
Gebruik dit wanneer je Tavily-specifieke zoekinstellingen wilt in plaats van de generieke `web_search`.
| Parameter | Type | Beperkingen / standaardwaarde | Beschrijving |
| ----------------- | ------------ | ---------------------------------------- | -------------------------------------------------------------- |
| `query` | string | vereist | Zoekquerystring. Houd deze onder 400 tekens. |
| `search_depth` | enum | `basic` (standaard), `advanced` | `advanced` is langzamer maar relevanter. |
| `topic` | enum | `general` (standaard), `news`, `finance` | Filter op onderwerpfamilie. |
| `max_results` | integer | 1-20 | Aantal resultaten. |
| `include_answer` | boolean | standaard `false` | Voeg een door Tavily AI gegenereerde antwoordsamenvatting toe. |
| `time_range` | enum | `day`, `week`, `month`, `year` | Filter resultaten op recentheid. |
| `include_domains` | string array | (geen) | Neem alleen resultaten van deze domeinen op. |
| `exclude_domains` | string array | (geen) | Sluit resultaten van deze domeinen uit. |
Afweging bij zoekdiepte:
| Diepte | Snelheid | Relevantie | Beste voor |
| ---------- | --------- | ---------- | ---------------------------------------- |
| `basic` | Sneller | Hoog | Algemene queries (standaard). |
| `advanced` | Langzamer | Hoogst | Nauwkeurig 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.
| Parameter | Type | Beperkingen / standaardwaarde | Beschrijving |
| ------------------- | ------------ | ------------------------------- | -------------------------------------------------------------------------------------------- |
| `urls` | string array | vereist, 1-20 | URL's waaruit content moet worden geëxtraheerd. |
| `query` | string | (optioneel) | Rangschik geëxtraheerde chunks opnieuw op relevantie voor deze query. |
| `extract_depth` | enum | `basic` (standaard), `advanced` | Gebruik `advanced` voor JS-intensieve pagina's, SPA's of dynamische tabellen. |
| `chunks_per_source` | integer | 1-5; **vereist `query`** | Chunks die per URL worden geretourneerd. Geeft een fout als dit zonder `query` is ingesteld. |
| `include_images` | boolean | standaard `false` | Neem afbeeldings-URL's op in resultaten. |
Afweging bij extractiediepte:
| Diepte | Wanneer te gebruiken |
| ---------- | ------------------------------------------------------- |
| `basic` | Eenvoudige pagina's. Probeer dit eerst. |
| `advanced` | Door 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
| Behoefte | Tool |
| -------------------------------------------- | ---------------- |
| Snelle webzoekopdracht, geen speciale opties | `web_search` |
| Zoeken met diepte, onderwerp, AI-antwoorden | `tavily_search` |
| Content extraheren uit specifieke URL's | `tavily_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
Alle providers en regels voor automatische detectie.
Zoeken plus scraping met contentextractie.
Neuraal zoeken met contentextractie.
Volledig configschema voor Plugin-vermeldingen en toolroutering.