Vai al contenuto principale

​
Ricerca Gemini

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

​
Ottenere una chiave API

1

Creare una chiave

Vai a Google AI Studio e crea una chiave API.
2

Memorizzare la chiave

Imposta GEMINI_API_KEY nell’ambiente del Gateway, oppure configura tramite:
openclaw configure --section web

​
Configurazione

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // facoltativo se GEMINI_API_KEY è impostato
            model: "gemini-2.5-flash", // predefinito
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
Alternativa con variabile d’ambiente: imposta GEMINI_API_KEY nell’ambiente del Gateway. Per un’installazione del gateway, inseriscilo 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’IA con citazioni inline. I risultati includono sia la risposta sintetizzata sia gli URL delle fonti.
  • Gli URL di citazione dal grounding Gemini vengono risolti automaticamente dagli URL di reindirizzamento Google agli URL diretti.
  • La risoluzione dei reindirizzamenti usa il percorso di protezione SSRF (controlli HEAD + redirect + validazione http/https) prima di restituire l’URL finale della citazione.
  • La risoluzione dei reindirizzamenti usa i valori predefiniti SSRF rigorosi, quindi i reindirizzamenti verso target privati/interni vengono bloccati.

​
Parametri supportati

La ricerca Gemini supporta query. count è accettato per compatibilità con web_search condiviso, ma il grounding Gemini restituisce comunque una singola risposta sintetizzata con citazioni anziché un elenco di N risultati. I filtri specifici del provider come country, language, freshness e domain_filter non sono supportati.

​
Selezione del modello

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

​
Correlati