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

Tools

Ricerca Brave

OpenClaw supporta l'API Brave Search come provider di web_search.

Ottenere una chiave API

  1. Crea un account per l'API Brave Search all'indirizzo https://brave.com/search/api/
  2. Nella dashboard, scegli il piano Search e genera una chiave API.
  3. Memorizza la chiave nella configurazione oppure imposta BRAVE_API_KEY nell'ambiente del Gateway.

Esempio di configurazione

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // oppure "llm-context"            baseUrl: "https://api.search.brave.com", // sostituzione facoltativa del proxy/URL di base          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Le impostazioni di ricerca specifiche del provider Brave si trovano in plugins.entries.brave.config.webSearch.*; questo è il percorso di configurazione canonico. Un valore condiviso di primo livello tools.web.search.apiKey e i valori con ambito tools.web.search.brave.* vengono ancora caricati tramite un'unione di compatibilità, ma le nuove configurazioni devono utilizzare il percorso con ambito del Plugin indicato sopra.

webSearch.mode controlla il trasporto Brave:

  • web (predefinito): normale ricerca web Brave con titoli, URL e frammenti
  • llm-context: API Brave LLM Context con blocchi di testo e fonti pre-estratti per l'ancoraggio

webSearch.baseUrl può indirizzare le richieste Brave a un proxy o Gateway attendibile e compatibile con Brave. OpenClaw aggiunge /res/v1/web/search o /res/v1/llm/context all'URL di base configurato e mantiene l'URL di base nella chiave della cache. Gli endpoint pubblici devono usare https://; http:// è accettato solo per host proxy local loopback attendibili o della rete privata.

Parametri dello strumento

querystringrequired

Query di ricerca.

countnumberdefault: 5

Numero di risultati da restituire (1–10).

countrystring

Codice paese ISO a 2 lettere (ad es. US, DE).

languagestring

Codice lingua ISO 639-1 per i risultati di ricerca (ad es. en, de, fr).

search_langstring

Codice della lingua di ricerca Brave (ad es. en, en-gb, zh-hans).

ui_langstring

Codice lingua ISO per gli elementi dell'interfaccia utente.

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

Filtro temporale: day corrisponde a 24 ore.

date_afterstring

Solo risultati pubblicati dopo questa data (YYYY-MM-DD).

date_beforestring

Solo risultati pubblicati prima di questa data (YYYY-MM-DD).

Esempi:

javascript
// Ricerca specifica per paese e linguaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Risultati recenti (ultima settimana)await web_search({  query: "AI news",  freshness: "week",}); // Ricerca per intervallo di dateawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Note

  • OpenClaw utilizza il piano Search di Brave. Se disponi di un abbonamento precedente (ad es. il piano Free originale con 2.000 query al mese), rimane valido ma non include funzionalità più recenti come LLM Context o limiti di frequenza più elevati.
  • Ogni piano Brave include $5 al mese di credito gratuito (rinnovabile). Il piano Search costa $5 ogni 1.000 richieste, quindi il credito copre 1.000 query al mese. Imposta il limite di utilizzo nella dashboard Brave per evitare addebiti imprevisti. Consulta il portale API di Brave per i piani attuali.
  • Il piano Search include l'endpoint LLM Context e i diritti di inferenza IA. La memorizzazione dei risultati per addestrare o perfezionare modelli richiede un piano con diritti di archiviazione espliciti. Consulta i Termini di servizio di Brave.
  • La modalità llm-context restituisce voci di fonti ancorate anziché il normale formato con frammenti della ricerca web.
  • La modalità llm-context supporta freshness e intervalli delimitati da date_after + date_before. Non supporta ui_lang; date_before senza date_after viene rifiutato perché Brave richiede che gli intervalli di attualità personalizzati includano sia la data iniziale sia quella finale.
  • ui_lang deve includere un sottotag regionale, ad esempio en-US.
  • Per impostazione predefinita, i risultati vengono memorizzati nella cache per 15 minuti (configurabile tramite cacheTtlMinutes).
  • I valori personalizzati di webSearch.baseUrl sono inclusi nell'identità della cache Brave, quindi le risposte specifiche del proxy non entrano in conflitto.
  • Abilita il flag di diagnostica brave.http per registrare gli URL e i parametri di query delle richieste Brave, lo stato e i tempi delle risposte e gli eventi di riscontro positivo, mancato riscontro e scrittura della cache di ricerca durante la risoluzione dei problemi. Il flag non registra mai la chiave API né i corpi delle risposte, ma le query di ricerca possono contenere dati sensibili.

Contenuti correlati

Was this useful?
On this page

On this page