Ricerca Gemini

OpenClaw supporta i modelli Gemini con grounding di Google Search integrato, che restituisce risposte sintetizzate dall'IA basate su 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, quindi models.providers.google.apiKey. Per gli URL di base, il valore dedicato plugins.entries.google.config.webSearch.baseUrl ha la precedenza su models.providers.google.baseUrl.

Per un'installazione del gateway, inserisci le chiavi env 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 delle citazioni dal grounding di 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 con web_search, ma il grounding di Gemini restituisce comunque una singola risposta sintetizzata con citazioni anziché un elenco di N risultati.

freshness accetta day, week, month, year e le scorciatoie condivise pd, pw, pm e py. OpenClaw converte questi valori, o un intervallo esplicito date_after/date_before, nel timeRangeFilter del grounding di Google Search di Gemini. country, language e domain_filter non sono supportati.

# Selezione del modello

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

# Override dell'URL di 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 valore semplice https://generativelanguage.googleapis.com viene normalizzato in https://generativelanguage.googleapis.com/v1beta; i percorsi proxy personalizzati vengono mantenuti come forniti dopo la rimozione degli slash 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