Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Crea una chiave

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

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:
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