Tools

Búsqueda de Exa

OpenClaw admite Exa AI como proveedor de web_search. Exa ofrece modos de búsqueda neural, por palabras clave e híbrida con extracción de contenido integrada (resaltados, texto, resúmenes).

Obtener una clave de API

  • Create an account

    Regístrate en exa.ai y genera una clave de API desde tu panel.

  • Store the key

    Establece EXA_API_KEY en el entorno del Gateway, o configúralo mediante:

    openclaw configure --section web
    
  • Configuración

    {
      plugins: {
        entries: {
          exa: {
            config: {
              webSearch: {
                apiKey: "exa-...", // optional if EXA_API_KEY is set
                baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
              },
            },
          },
        },
      },
      tools: {
        web: {
          search: {
            provider: "exa",
          },
        },
      },
    }
    

    Alternativa de entorno: establece EXA_API_KEY en el entorno del Gateway. Para una instalación del gateway, colócala en ~/.openclaw/.env.

    Anulación de URL base

    Establece plugins.entries.exa.config.webSearch.baseUrl cuando las solicitudes de búsqueda de Exa deban pasar por un proxy compatible o un endpoint alternativo de Exa. OpenClaw normaliza los hosts sin esquema anteponiendo https:// y añade /search a menos que la ruta ya termine allí. El endpoint resuelto se incluye en la clave de caché de búsqueda, por lo que los resultados de distintos endpoints de Exa no se comparten.

    Parámetros de la herramienta

    querystringrequired

    Consulta de búsqueda.

    countnumber

    Resultados que se devolverán (1–100).

    type'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'

    Modo de búsqueda.

    freshness'day' | 'week' | 'month' | 'year'

    Filtro de tiempo.

    date_afterstring

    Resultados posteriores a esta fecha (YYYY-MM-DD).

    date_beforestring

    Resultados anteriores a esta fecha (YYYY-MM-DD).

    contentsobject

    Opciones de extracción de contenido (ver más abajo).

    Extracción de contenido

    Exa puede devolver contenido extraído junto con los resultados de búsqueda. Pasa un objeto contents para activarlo:

    await web_search({
      query: "transformer architecture explained",
      type: "neural",
      contents: {
        text: true, // full page text
        highlights: { numSentences: 3 }, // key sentences
        summary: true, // AI summary
      },
    });
    
    Opción de contents Tipo Descripción
    text boolean | { maxCharacters } Extraer texto completo de la página
    highlights boolean | { maxCharacters, query, numSentences, highlightsPerUrl } Extraer frases clave
    summary boolean | { query } Resumen generado por IA

    Modos de búsqueda

    Modo Descripción
    auto Exa elige el mejor modo (predeterminado)
    neural Búsqueda semántica/basada en significado
    fast Búsqueda rápida por palabras clave
    deep Búsqueda profunda y exhaustiva
    deep-reasoning Búsqueda profunda con razonamiento
    instant Resultados más rápidos

    Notas

    • Si no se proporciona ninguna opción de contents, Exa usa de forma predeterminada { highlights: true } para que los resultados incluyan extractos de frases clave
    • Los resultados conservan los campos highlightScores y summary de la respuesta de la API de Exa cuando están disponibles
    • Las descripciones de los resultados se resuelven primero a partir de los resaltados, luego del resumen y luego del texto completo — lo que esté disponible
    • freshness y date_after/date_before no se pueden combinar — usa un solo modo de filtro temporal
    • Se pueden devolver hasta 100 resultados por consulta (sujeto a los límites de tipo de búsqueda de Exa)
    • Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (configurable mediante cacheTtlMinutes)
    • Exa es una integración oficial de API con respuestas JSON estructuradas

    Relacionado