Tools

Ricerca Exa

OpenClaw supporta Exa AI come provider web_search. Exa offre modalità di ricerca neurale, per parole chiave e ibrida con estrazione dei contenuti integrata (evidenziazioni, testo, riepiloghi).

Installa Plugin

Installa il Plugin ufficiale, poi riavvia Gateway:

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

Ottieni una chiave API

Crea un account

Registrati su exa.ai e genera una chiave API dalla tua dashboard.

Archivia la chiave

Imposta EXA_API_KEY nell'ambiente Gateway, oppure configura tramite:

bash

openclaw configure --section web

Configurazione

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // optional if EXA_API_KEY is set            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

Alternativa di ambiente: imposta EXA_API_KEY nell'ambiente Gateway. Per un'installazione gateway, inseriscilo in ~/.openclaw/.env.

Override dell'URL di base

Imposta plugins.entries.exa.config.webSearch.baseUrl quando le richieste di ricerca Exa devono passare attraverso un proxy compatibile o un endpoint Exa alternativo. OpenClaw normalizza gli host semplici anteponendo https:// e aggiunge /search a meno che il percorso non termini già così. L'endpoint risolto è incluso nella chiave della cache di ricerca, quindi i risultati da endpoint Exa diversi non vengono condivisi.

Parametri dello strumento

querystringrequired

Query di ricerca.

countnumber

Risultati da restituire (1–100).

Modalità di ricerca.

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

Filtro temporale.

date_afterstring

Risultati successivi a questa data (YYYY-MM-DD).

date_beforestring

Risultati precedenti a questa data (YYYY-MM-DD).

contentsobject

Opzioni di estrazione dei contenuti (vedi sotto).

Estrazione dei contenuti

Exa può restituire contenuti estratti insieme ai risultati di ricerca. Passa un oggetto contents per abilitarla:

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // full page text    highlights: { numSentences: 3 }, // key sentences    summary: true, // AI summary  },});

Opzione Contents	Tipo	Descrizione
`text`	`boolean \| { maxCharacters }`	Estrai il testo completo della pagina
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Estrai frasi chiave
`summary`	`boolean \| { query }`	Riepilogo generato dall'IA

Modalità di ricerca

Modalità	Descrizione
`auto`	Exa sceglie la modalità migliore (predefinita)
`neural`	Ricerca semantica/basata sul significato
`fast`	Ricerca rapida per parole chiave
`deep`	Ricerca approfondita
`deep-reasoning`	Ricerca approfondita con ragionamento
`instant`	Risultati più rapidi

Note

Se non viene fornita alcuna opzione contents, Exa usa per impostazione predefinita { highlights: true }, quindi i risultati includono estratti di frasi chiave
I risultati preservano i campi highlightScores e summary dalla risposta dell'API Exa quando disponibili
Le descrizioni dei risultati vengono risolte prima dalle evidenziazioni, poi dal riepilogo, poi dal testo completo — a seconda di ciò che è disponibile
freshness e date_after/date_before non possono essere combinati — usa una sola modalità di filtro temporale
Possono essere restituiti fino a 100 risultati per query (soggetto ai limiti del tipo di ricerca Exa)
I risultati vengono memorizzati nella cache per 15 minuti per impostazione predefinita (configurabile tramite cacheTtlMinutes)
Exa è un'integrazione API ufficiale con risposte JSON strutturate

Correlati

Panoramica di Web Search -- tutti i provider e il rilevamento automatico
Brave Search -- risultati strutturati con filtri paese/lingua
Perplexity Search -- risultati strutturati con filtro per dominio

Was this useful?