Búsqueda de Gemini

OpenClaw admite modelos Gemini con grounding de Google Search integrado, que devuelve respuestas sintetizadas por IA respaldadas por resultados en vivo de Google Search con citas.

Obtener una clave de API

openclaw configure --section web

Configuración

{  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",      },    },  },}

Precedencia de credenciales: La búsqueda web de Gemini usa primero plugins.entries.google.config.webSearch.apiKey, luego GEMINI_API_KEY y después models.providers.google.apiKey. Para las URL base, la opción dedicada plugins.entries.google.config.webSearch.baseUrl tiene prioridad sobre models.providers.google.baseUrl.

Para una instalación de 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 grounding de Google Search para producir respuestas sintetizadas por IA con citas en línea. Los resultados incluyen tanto la respuesta sintetizada como las URL de origen.

• Las URL de citas de Gemini grounding se resuelven automáticamente desde URL de redirección de Google a URL directas.
• La resolución de redirecciones usa la ruta de protección SSRF (HEAD + comprobaciones de redirección + validación http/https) antes de devolver la URL de cita final.
• La resolución de redirecciones usa valores predeterminados estrictos de SSRF, por lo que se bloquean las redirecciones a destinos privados/internos.

Parámetros admitidos

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

count se acepta por compatibilidad compartida con web_search, pero Gemini grounding sigue devolviendo una sola 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 Google Search grounding de Gemini. country, language y domain_filter no son compatibles.

Selección de modelo

El modelo predeterminado es gemini-2.5-flash (rápido y rentable). Cualquier modelo Gemini que admita grounding puede usarse mediante plugins.entries.google.config.webSearch.model.

Reemplazos de URL base

Define plugins.entries.google.config.webSearch.baseUrl cuando la búsqueda web de Gemini deba enrutarse mediante un proxy de 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 a https://generativelanguage.googleapis.com/v1beta; las rutas de proxy personalizadas se conservan tal como se proporcionan después de recortar las barras finales.

Relacionado

• Resumen de Web Search -- todos los proveedores y detección automática
• Brave Search -- resultados estructurados con fragmentos
• Perplexity Search -- resultados estructurados + extracción de contenido