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

Tools

Brave-zoekopdracht

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", // of "llm-context"            baseUrl: "https://api.search.brave.com", // optionele overschrijving van proxy-/basis-URL          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Providerspecifieke Brave-zoekinstellingen staan onder plugins.entries.brave.config.webSearch.*; dit is het canonieke configuratiepad. Een gedeelde tools.web.search.apiKey op het hoogste niveau en een bereikgebonden tools.web.search.brave.* worden nog steeds geladen via een compatibiliteitssamenvoeging, maar nieuwe configuraties moeten het bovenstaande Plugin-pad gebruiken.

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-aanvragen doorsturen naar een vertrouwde Brave-compatibele proxy of gateway. 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 local loopback- of proxyd hosts in een privénetwerk.

Toolparameters

querystringrequired

Zoekopdracht.

countnumberdefault: 5

Aantal te retourneren resultaten (1–10).

countrystring

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

languagestring

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

search_langstring

Brave-code voor de zoektaal (bijvoorbeeld 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
// Land- en taalspecifieke zoekopdrachtawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Recente resultaten (afgelopen week)await web_search({  query: "AI news",  freshness: "week",}); // Zoeken binnen een datumbereikawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Opmerkingen

  • OpenClaw gebruikt het Brave-abonnement Search. Als u een ouder abonnement hebt (bijvoorbeeld het oorspronkelijke Free-abonnement met 2.000 zoekopdrachten per maand), blijft dit geldig, maar bevat het geen nieuwere functies zoals LLM Context of hogere snelheidslimieten.
  • Elk Brave-abonnement bevat $5 per maand aan gratis tegoed (dat wordt vernieuwd). Het Search-abonnement kost $5 per 1.000 aanvragen, dus het tegoed dekt 1.000 zoekopdrachten per maand. Stel uw gebruikslimiet in het Brave-dashboard in om onverwachte kosten te voorkomen. Raadpleeg het Brave API-portaal voor de huidige 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. Raadpleeg 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. ui_lang wordt niet ondersteund; date_before zonder date_after wordt geweigerd, omdat Brave vereist dat aangepaste actualiteitsbereiken zowel een begin- als een 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 met elkaar conflicteren.
  • Schakel de diagnostische vlag brave.http in om tijdens probleemoplossing Brave-aanvraag-URL's/queryparameters, antwoordstatus/timing en gebeurtenissen voor treffers, missers en schrijfacties in de zoekcache te loggen. De vlag logt nooit de API-sleutel of antwoordinhoud, maar zoekopdrachten kunnen gevoelig zijn.

Gerelateerd

Was this useful?
On this page

On this page