Saltar al contenido principal

Búsqueda 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

1

Crea una cuenta

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

Guarda la clave

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-...", // opcional si EXA_API_KEY está establecido
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
Alternativa de entorno: establece EXA_API_KEY en el entorno del Gateway. Para una instalación del gateway, colócalo en ~/.openclaw/.env.

Parámetros de la herramienta

ParámetroDescripción
queryConsulta de búsqueda (obligatoria)
countResultados que se devolverán (1-100)
typeModo de búsqueda: auto, neural, fast, deep, deep-reasoning o instant
freshnessFiltro temporal: day, week, month o year
date_afterResultados posteriores a esta fecha (YYYY-MM-DD)
date_beforeResultados anteriores a esta fecha (YYYY-MM-DD)
contentsOpciones de extracción de contenido (consulta abajo)

Extracción de contenido

Exa puede devolver contenido extraído junto con los resultados de búsqueda. Pasa un objeto contents para habilitarlo:
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // texto completo de la página
    highlights: { numSentences: 3 }, // frases clave
    summary: true, // resumen de IA
  },
});
Opción de contentsTipoDescripción
textboolean | { maxCharacters }Extrae el texto completo de la página
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Extrae frases clave
summaryboolean | { query }Resumen generado por IA

Modos de búsqueda

ModoDescripción
autoExa elige el mejor modo (predeterminado)
neuralBúsqueda semántica/basada en significado
fastBúsqueda rápida por palabras clave
deepBúsqueda profunda exhaustiva
deep-reasoningBúsqueda profunda con razonamiento
instantResultados más rápidos

Notas

  • Si no se proporciona ninguna opción 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 highlights, luego de summary, y después del texto completo; se usa lo que esté disponible
  • freshness y date_after/date_before no pueden combinarse; usa un único modo de filtro temporal
  • Se pueden devolver hasta 100 resultados por consulta (sujeto a los límites del 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