Búsqueda de Gemini

OpenClaw admite modelos Gemini con fundamentación integrada de Google Search, que devuelve respuestas sintetizadas por IA respaldadas por resultados activos 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 plugins.entries.google.config.webSearch.apiKey primero, 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 la fundamentación 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 la fundamentación de Gemini 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 para compatibilidad compartida con web_search, pero la fundamentación de Gemini sigue devolviendo una 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. OpenClaw convierte estos valores, o un rango explícito date_after/date_before, en el timeRangeFilter de la fundamentación de Google Search 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 fundamentación puede usarse mediante plugins.entries.google.config.webSearch.model.

# Sobrescrituras de URL base

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

# Relacionado

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