Tools

Brave-zoekopdracht

OpenClaw ondersteunt Brave Search API als web_search-provider.

Een API-sleutel verkrijgen

Maak een Brave Search API-account aan op https://brave.com/search/api/
Kies in het dashboard het Search-abonnement en genereer een API-sleutel.
Sla de sleutel op in de configuratie of stel BRAVE_API_KEY in de Gateway-omgeving in.

Configuratievoorbeeld

json5

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // of "llm-context"            baseUrl: "https://api.search.brave.com", // optionele proxy-/basis-URL-overschrijving          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Providerspecifieke Brave-zoekinstellingen staan onder plugins.entries.brave.config.webSearch.*; dit is het canonieke configuratiepad.

webSearch.mode bepaalt het Brave-transport:

web (standaard): normale Brave-webzoekopdracht met titels, URL's en fragmenten
llm-context: Brave LLM Context API met vooraf geëxtraheerde tekstfragmenten en bronnen voor onderbouwing

webSearch.baseUrl kan Brave-verzoeken naar een vertrouwde Brave-compatibele proxy of gateway sturen. OpenClaw voegt /res/v1/web/search of /res/v1/llm/context toe aan de geconfigureerde basis-URL en neemt de basis-URL op in de cachesleutel. Openbare eindpunten moeten https:// gebruiken; http:// wordt alleen geaccepteerd voor vertrouwde loopback- of proxihosts in een privénetwerk.

Toolparameters

querystringrequired

Zoekopdracht.

countnumberdefault: 5

Aantal te retourneren resultaten (1–10).

countrystring

ISO-landcode van 2 letters (bijv. US, DE).

languagestring

ISO 639-1-taalcode voor zoekresultaten (bijv. en, de, fr).

search_langstring

Brave-code voor de zoektaal (bijv. en, en-gb, zh-hans).

ui_langstring

ISO-taalcode voor UI-elementen.

freshness'day' | 'week' | 'month' | 'year'

Tijdfilter — day is 24 uur.

date_afterstring

Alleen resultaten die na deze datum zijn gepubliceerd (YYYY-MM-DD).

date_beforestring

Alleen resultaten die vóór deze datum zijn gepubliceerd (YYYY-MM-DD).

Voorbeelden:

javascript

// Zoekopdracht specifiek voor land en taalawait web_search({  query: "hernieuwbare energie",  country: "DE",  language: "de",}); // Recente resultaten (afgelopen week)await web_search({  query: "AI-nieuws",  freshness: "week",}); // Zoeken binnen een datumbereikawait web_search({  query: "AI-ontwikkelingen",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Opmerkingen

OpenClaw gebruikt het Brave Search-abonnement. Als je een verouderd abonnement hebt (bijv. het oorspronkelijke Free-abonnement met 2.000 zoekopdrachten/maand), blijft dit geldig, maar bevat het geen nieuwere functies zoals LLM Context of hogere snelheidslimieten.
Elk Brave-abonnement bevat $5/maand aan gratis tegoed (wordt vernieuwd). Het Search-abonnement kost $5 per 1.000 verzoeken, dus het tegoed dekt 1.000 zoekopdrachten/maand. Stel je gebruikslimiet in het Brave-dashboard in om onverwachte kosten te voorkomen. Zie de Brave API-portal voor de actuele abonnementen.
Het Search-abonnement bevat het LLM Context-eindpunt en rechten voor AI-inferentie. Voor het opslaan van resultaten om modellen te trainen of af te stemmen, is een abonnement met expliciete opslagrechten vereist. Zie de Servicevoorwaarden van Brave.
De modus llm-context retourneert onderbouwde bronvermeldingen in plaats van de normale fragmentstructuur voor webzoekopdrachten.
De modus llm-context ondersteunt freshness en begrensde bereiken met date_after + date_before. Deze ondersteunt ui_lang niet; date_before zonder date_after wordt geweigerd, omdat Brave vereist dat aangepaste versheidsbereiken zowel een begin- als einddatum bevatten.
ui_lang moet een regio-subtag bevatten, zoals en-US.
Resultaten worden standaard 15 minuten in de cache opgeslagen (configureerbaar via cacheTtlMinutes).
Aangepaste waarden voor webSearch.baseUrl worden opgenomen in de Brave-cache-identiteit, zodat proxyspecifieke antwoorden niet conflicteren.
Schakel de diagnostische vlag brave.http in om tijdens probleemoplossing URL's/queryparameters van Brave-verzoeken, de responsstatus/-timing en treffers, missers en schrijfbewerkingen van de zoekcache te loggen. De vlag logt nooit de API-sleutel of responsinhoud, maar zoekopdrachten kunnen gevoelig zijn.

Gerelateerd

Overzicht van Web Search -- alle providers en automatische detectie
Perplexity Search -- gestructureerde resultaten met domeinfiltering
Exa Search -- neuraal zoeken met inhoudsextractie

Was this useful?