> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ricerca Gemini

OpenClaw supporta i modelli Gemini con
[grounding di Google Search](https://ai.google.dev/gemini-api/docs/grounding)
integrato, che restituisce risposte sintetizzate dall'AI supportate da risultati
live di Google Search con citazioni.

## Ottieni una chiave API

<Steps>
  <Step title="Crea una chiave">
    Vai a [Google AI Studio](https://aistudio.google.com/apikey) e crea una
    chiave API.
  </Step>

  <Step title="Archivia la chiave">
    Imposta `GEMINI_API_KEY` nell'ambiente del Gateway, riutilizza
    `models.providers.google.apiKey`, oppure configura una chiave dedicata per la ricerca web tramite:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```
  </Step>
</Steps>

## Configurazione

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](/it/tools/web) -- tutti i provider e il rilevamento automatico
* [Brave Search](/it/tools/brave-search) -- risultati strutturati con snippet
* [Perplexity Search](/it/tools/perplexity-search) -- risultati strutturati + estrazione dei contenuti