Recherche Gemini

OpenClaw prend en charge les modèles Gemini avec une fonctionnalité intégrée d’ ancrage dans Google Search, qui renvoie des réponses synthétisées par l’IA, étayées par des résultats Google Search en direct et accompagnées de citations.

Obtenir une clé API

openclaw configure --section web

Configuration

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // facultatif si GEMINI_API_KEY ou models.providers.google.apiKey est défini            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // facultatif ; utilise models.providers.google.baseUrl comme solution de repli            model: "gemini-2.5-flash", // valeur par défaut          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

Ordre de priorité des identifiants : la recherche Web Gemini utilise d’abord plugins.entries.google.config.webSearch.apiKey, puis GEMINI_API_KEY, puis models.providers.google.apiKey. Pour les URL de base, la valeur dédiée plugins.entries.google.config.webSearch.baseUrl est prioritaire sur models.providers.google.baseUrl.

Pour une installation du Gateway, placez les clés d’environnement dans ~/.openclaw/.env.

Fonctionnement

Contrairement aux fournisseurs de recherche traditionnels qui renvoient une liste de liens et d’extraits, Gemini utilise l’ancrage dans Google Search pour produire des réponses synthétisées par l’IA avec des citations intégrées. Les résultats comprennent à la fois la réponse synthétisée et les URL des sources.

• Les URL de citation issues de l’ancrage Gemini sont automatiquement converties depuis les URL de redirection Google en URL directes au moyen d’une requête HEAD passant par le chemin de récupération d’OpenClaw protégé contre les SSRF (suivi des redirections, validation http/https).
• La résolution des redirections utilise des paramètres SSRF stricts par défaut ; les redirections vers des cibles privées ou internes sont donc bloquées.

Paramètres pris en charge

La recherche Gemini prend en charge query, freshness, date_after et date_before.

count est accepté pour assurer la compatibilité avec l’outil web_search partagé, mais l’ancrage Gemini renvoie toujours une seule réponse synthétisée avec des citations, plutôt qu’une liste de N résultats.

freshness accepte day, week, month, year, ainsi que les raccourcis partagés pd, pw, pm et py. day/pd ajoute une instruction de récence à la requête Gemini au lieu d’imposer une plage stricte de 24 heures. week, month, year et les plages explicites date_after/date_before définissent le timeRangeFilter de l’ancrage Google Search de Gemini. country, language et domain_filter ne sont pas pris en charge.

Sélection du modèle

Le modèle par défaut est gemini-2.5-flash (rapide et économique). Tout modèle Gemini prenant en charge l’ancrage peut être utilisé au moyen de plugins.entries.google.config.webSearch.model.

Remplacement de l’URL de base

Définissez plugins.entries.google.config.webSearch.baseUrl lorsque la recherche Web Gemini doit transiter par un proxy d’opérateur ou un point de terminaison personnalisé compatible avec Gemini. Si cette valeur n’est pas définie, la recherche Web Gemini réutilise models.providers.google.baseUrl. Une valeur simple https://generativelanguage.googleapis.com est normalisée en https://generativelanguage.googleapis.com/v1beta ; les chemins de proxy personnalisés sont conservés tels qu’ils sont fournis après suppression des barres obliques finales.

Voir aussi

• Présentation de la recherche Web -- tous les fournisseurs et la détection automatique
• Brave Search -- résultats structurés avec extraits
• Perplexity Search -- résultats structurés et extraction de contenu