Ricerca Gemini

OpenClaw supporta i modelli Gemini con grounding di Google Search integrato, che restituisce risposte sintetizzate dall'AI supportate da risultati live di Google Search con citazioni.

Ottieni una chiave API

openclaw configure --section web

Configurazione

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; falls back to models.providers.google.baseUrl            model: "gemini-2.5-flash", // default          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

Precedenza delle credenziali: la ricerca web Gemini usa prima plugins.entries.google.config.webSearch.apiKey, poi GEMINI_API_KEY, poi models.providers.google.apiKey. Per gli URL base, il valore dedicato plugins.entries.google.config.webSearch.baseUrl ha la precedenza su models.providers.google.baseUrl.

Per un'installazione gateway, inserisci le chiavi di ambiente in ~/.openclaw/.env.

Come funziona

A differenza dei provider di ricerca tradizionali che restituiscono un elenco di link e snippet, Gemini usa il grounding di Google Search per produrre risposte sintetizzate dall'AI con citazioni inline. I risultati includono sia la risposta sintetizzata sia gli URL di origine.

• Gli URL delle citazioni dal grounding Gemini vengono risolti automaticamente dagli URL di reindirizzamento di Google agli URL diretti.
• La risoluzione dei reindirizzamenti usa il percorso di protezione SSRF (HEAD + controlli dei reindirizzamenti + convalida http/https) prima di restituire l'URL finale della citazione.
• La risoluzione dei reindirizzamenti usa impostazioni predefinite SSRF rigorose, quindi i reindirizzamenti verso destinazioni private/interne vengono bloccati.

Parametri supportati

La ricerca Gemini supporta query, freshness, date_after e date_before.

count è accettato per la compatibilità condivisa di web_search, ma il grounding Gemini restituisce comunque una sola risposta sintetizzata con citazioni invece di un elenco di N risultati.

freshness accetta day, week, month, year e le scorciatoie condivise pd, pw, pm e py. day/pd aggiunge un'istruzione di recenza alla query Gemini invece di un intervallo rigido di 24 ore. week, month, year e gli intervalli espliciti date_after/date_before impostano timeRangeFilter del grounding Gemini Google Search. country, language e domain_filter non sono supportati.

Selezione del modello

Il modello predefinito è gemini-2.5-flash (rapido ed economicamente conveniente). Qualsiasi modello Gemini che supporta il grounding può essere usato tramite plugins.entries.google.config.webSearch.model.

Override dell'URL base

Imposta plugins.entries.google.config.webSearch.baseUrl quando la ricerca web Gemini deve passare attraverso un proxy dell'operatore o un endpoint personalizzato compatibile con Gemini. Se non è impostato, la ricerca web Gemini riutilizza models.providers.google.baseUrl. Un semplice valore https://generativelanguage.googleapis.com viene normalizzato in https://generativelanguage.googleapis.com/v1beta; i percorsi proxy personalizzati vengono mantenuti come forniti dopo aver rimosso le barre finali.

Correlati

• Panoramica di Web Search -- tutti i provider e il rilevamento automatico
• Brave Search -- risultati strutturati con snippet
• Perplexity Search -- risultati strutturati + estrazione dei contenuti