English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Tools

Brave zoeken

OpenClaw ondersteunt de Brave Search API als web_search-provider.

Een API-sleutel verkrijgen

  1. Maak een Brave Search API-account aan op https://brave.com/search/api/
  2. Kies in het dashboard het Search-abonnement en genereer een API-sleutel.
  3. 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", // or "llm-context"            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Providerspecifieke Brave-zoekinstellingen staan nu onder plugins.entries.brave.config.webSearch.*. De verouderde tools.web.search.apiKey wordt nog steeds geladen via de compatibiliteitsshim, maar is niet langer het canonieke configuratiepad.

webSearch.mode bepaalt de Brave-transportlaag:

  • web (standaard): normale Brave-webzoekfunctie met titels, URL's en snippets
  • llm-context: Brave LLM Context API met vooraf geëxtraheerde tekstfragmenten en bronnen voor grounding

webSearch.baseUrl kan Brave-verzoeken naar een vertrouwde Brave-compatibele proxy of Gateway laten wijzen. OpenClaw voegt /res/v1/web/search of /res/v1/llm/context toe aan de geconfigureerde basis-URL en houdt de basis-URL in de cachesleutel. Publieke endpoints moeten https:// gebruiken; http:// wordt alleen geaccepteerd voor vertrouwde loopback- of privénetwerk-proxyhosts.

Toolparameters

querystringrequired

Zoekquery.

countnumberdefault: 5

Aantal resultaten om terug te geven (1–10).

countrystring

2-letterige ISO-landcode (bijv. US, DE).

languagestring

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

search_langstring

Brave-zoektaalcode (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
// Country and language-specific searchawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Recent results (past week)await web_search({  query: "AI news",  freshness: "week",}); // Date range searchawait web_search({  query: "AI developments",  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 query's/maand), blijft dit geldig, maar het bevat geen nieuwere functies zoals LLM Context of hogere limieten.
  • Elk Brave-abonnement bevat $5/maand aan gratis tegoed (vernieuwend). Het Search-abonnement kost $5 per 1.000 verzoeken, dus het tegoed dekt 1.000 query's/maand. Stel je gebruikslimiet in het Brave-dashboard in om onverwachte kosten te voorkomen. Zie de Brave API-portal voor actuele abonnementen.
  • Het Search-abonnement bevat het LLM Context-endpoint en AI-inferentierechten. Resultaten opslaan om modellen te trainen of af te stemmen vereist een abonnement met expliciete opslagrechten. Zie de Brave Servicevoorwaarden.
  • De llm-context-modus retourneert gegronde bronitems in plaats van de normale snippetstructuur voor webzoekresultaten.
  • De llm-context-modus ondersteunt freshness en begrensde date_after + date_before-bereiken. Deze ondersteunt geen ui_lang; date_before zonder date_after wordt geweigerd omdat Brave vereist dat aangepaste versheidsbereiken zowel een begin- als einddatum bevatten.
  • ui_lang moet een regiosubtag bevatten, zoals en-US.
  • Resultaten worden standaard 15 minuten gecachet (configureerbaar via cacheTtlMinutes).
  • Aangepaste webSearch.baseUrl-waarden worden opgenomen in de Brave-cache-identiteit, zodat proxyspecifieke antwoorden niet botsen.
  • Schakel de diagnostische vlag brave.http in om Brave-verzoek-URL's/queryparameters, responsstatus/timing en zoekcache-hit/miss/write-gebeurtenissen te loggen tijdens probleemoplossing. De vlag logt nooit de API-sleutel of responsbody's, maar zoekquery's kunnen gevoelig zijn.

Gerelateerd

Was this useful?