Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Brave Search API

OpenClaw ondersteunt Brave Search API als een 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

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
          },
        },
      },
    },
  },
  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 compatibiliteitslaag, maar is niet langer het canonieke configuratiepad. webSearch.mode regelt het Brave-transport:
  • web (standaard): normale Brave-webzoekopdracht met titels, URL’s en fragmenten
  • llm-context: Brave LLM Context API met vooraf geextraheerde tekstblokken en bronnen voor onderbouwing

Toolparameters

query
string
vereist
Zoekquery.
count
number
standaard:"5"
Aantal resultaten dat moet worden teruggegeven (1-10).
country
string
2-letterige ISO-landcode (bijv. US, DE).
language
string
ISO 639-1-taalcode voor zoekresultaten (bijv. en, de, fr).
search_lang
string
Brave-zoektaalcode (bijv. en, en-gb, zh-hans).
ui_lang
string
ISO-taalcode voor UI-elementen.
freshness
'day' | 'week' | 'month' | 'year'
Tijdfilter — day is 24 uur.
date_after
string
Alleen resultaten die na deze datum zijn gepubliceerd (YYYY-MM-DD).
date_before
string
Alleen resultaten die voor deze datum zijn gepubliceerd (YYYY-MM-DD).
Voorbeelden:
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

Opmerkingen

  • OpenClaw gebruikt het Brave Search-abonnement. Als u een verouderd abonnement hebt (bijv. het oorspronkelijke Free-abonnement met 2.000 query’s/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 (vernieuwend). Het Search-abonnement kost $5 per 1.000 aanvragen, dus het tegoed dekt 1.000 query’s/maand. Stel uw gebruikslimiet in het Brave-dashboard in om onverwachte kosten te voorkomen. Zie het Brave API-portaal voor actuele abonnementen.
  • Het Search-abonnement bevat het LLM Context-eindpunt en AI-inferentierechten. Voor het opslaan van resultaten om modellen te trainen of af te stemmen is een abonnement met expliciete opslagrechten vereist. Zie de Brave Servicevoorwaarden.
  • De modus llm-context geeft onderbouwde bronvermeldingen terug in plaats van de normale fragmentvorm van webzoekopdrachten.
  • De modus llm-context ondersteunt ui_lang, freshness, date_after of date_before niet.
  • ui_lang moet een regio-subtag bevatten, zoals en-US.
  • Resultaten worden standaard 15 minuten in de cache opgeslagen (configureerbaar via cacheTtlMinutes).

Gerelateerd