Skip to main content
OpenClaw admite modelos Gemini con fundamentación de Google Search integrada, que devuelve respuestas sintetizadas por IA respaldadas por resultados de Google Search en vivo con citas.

​
Obtener una clave de API

1

Crear una clave

Ir a Google AI Studio y crear una clave de API.
2

Almacenar la clave

Establecer GEMINI_API_KEY en el entorno del Gateway, reutilizar models.providers.google.apiKey o configurar una clave dedicada para búsquedas web mediante:

​
Configuración

Precedencia de credenciales: la búsqueda web de Gemini utiliza primero plugins.entries.google.config.webSearch.apiKey, después GEMINI_API_KEY y, por último, models.providers.google.apiKey. Para las URL base, la configuración dedicada plugins.entries.google.config.webSearch.baseUrl tiene precedencia sobre models.providers.google.baseUrl. Para una instalación del Gateway, colocar las claves de entorno en ~/.openclaw/.env.

​
Cómo funciona

A diferencia de los proveedores de búsqueda tradicionales, que devuelven una lista de enlaces y fragmentos, Gemini utiliza la fundamentación de Google Search para generar respuestas sintetizadas por IA con citas integradas. Los resultados incluyen tanto la respuesta sintetizada como las URL de las fuentes.
  • Las URL de citas de la fundamentación de Gemini se resuelven automáticamente desde las URL de redirección de Google hasta las URL directas mediante una solicitud HEAD a través de la ruta de obtención protegida contra SSRF de OpenClaw (seguimiento de redirecciones, validación de http/https).
  • La resolución de redirecciones utiliza valores predeterminados estrictos contra SSRF, por lo que se bloquean las redirecciones a destinos privados o internos.

​
Parámetros compatibles

La búsqueda de Gemini admite query, freshness, date_after y date_before. count se acepta para mantener la compatibilidad compartida con web_search, pero la fundamentación de Gemini sigue devolviendo una única respuesta sintetizada con citas en lugar de una lista de N resultados. freshness acepta day, week, month, year y los atajos compartidos pd, pw, pm y py. day/pd añade una instrucción de actualidad a la consulta de Gemini en lugar de un intervalo estricto de 24 horas. week, month, year y los intervalos explícitos date_after/date_before establecen timeRangeFilter de la fundamentación de Google Search de Gemini. country, language y domain_filter no son compatibles.

​
Selección del modelo

El modelo predeterminado es gemini-2.5-flash (rápido y rentable). Se puede utilizar cualquier modelo de Gemini que admita fundamentación mediante plugins.entries.google.config.webSearch.model.

​
Anulaciones de la URL base

Establecer plugins.entries.google.config.webSearch.baseUrl cuando la búsqueda web de Gemini deba enrutarse a través de un proxy del operador o un endpoint personalizado compatible con Gemini. Si no se establece, la búsqueda web de Gemini reutiliza models.providers.google.baseUrl. Un valor simple de https://generativelanguage.googleapis.com se normaliza como https://generativelanguage.googleapis.com/v1beta; las rutas de proxy personalizadas se conservan tal como se proporcionan después de eliminar las barras diagonales finales.

​
Relacionado