Búsqueda de Gemini

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

Obtener una clave de API

openclaw configure --section web

Configuración

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // opcional si se ha definido GEMINI_API_KEY o models.providers.google.apiKey            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // opcional; recurre a models.providers.google.baseUrl            model: "gemini-2.5-flash", // predeterminado          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

Precedencia de credenciales: la búsqueda web de Gemini usa 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 específica plugins.entries.google.config.webSearch.baseUrl tiene precedencia sobre models.providers.google.baseUrl.

Para una instalación del Gateway, coloca 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 usa 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 las citas procedentes de la fundamentación de Gemini se resuelven automáticamente desde URL de redirección de Google a URL directas mediante una solicitud HEAD a través de la ruta de obtención protegida contra SSRF de OpenClaw (seguimiento de redirecciones y 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 admitidos

La búsqueda de Gemini admite query, freshness, date_after y date_before.

Se acepta count para mantener la compatibilidad con el web_search compartido, 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 el timeRangeFilter de la fundamentación de Google Search de Gemini. No se admiten country, language ni domain_filter.

Selección del modelo

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

Sustitución de la URL base

Define plugins.entries.google.config.webSearch.baseUrl cuando la búsqueda web de Gemini deba dirigirse a través de un proxy del operador o un endpoint personalizado compatible con Gemini. Si no se define, la búsqueda web de Gemini reutiliza models.providers.google.baseUrl. Un valor simple 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 finales.

Contenido relacionado

• Descripción general de la búsqueda web -- todos los proveedores y la detección automática
• Brave Search -- resultados estructurados con fragmentos
• Perplexity Search -- resultados estructurados y extracción de contenido