Tools

Búsqueda de Exa

Exa AI es un proveedor de web_search con modos de búsqueda neuronal, por palabras clave e híbrida, además de extracción de contenido integrada (fragmentos destacados, texto y resúmenes).

Instalar el Plugin

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

Obtener una clave de API

Crear una cuenta

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

Guardar la clave

Define EXA_API_KEY en el entorno del Gateway o configúrala mediante:

bash

openclaw configure --section web

Configuración

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // opcional si EXA_API_KEY está definida            baseUrl: "https://api.exa.ai", // opcional; OpenClaw añade /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

Alternativa mediante el entorno: define EXA_API_KEY en el entorno del Gateway. Para una instalación del Gateway, colócala en ~/.openclaw/.env. Consulta Variables de entorno.

Sobrescribir la URL base

Define plugins.entries.exa.config.webSearch.baseUrl para enrutar las solicitudes de búsqueda de Exa mediante un proxy compatible o un punto de conexión alternativo. OpenClaw normaliza los hosts sin protocolo anteponiendo https:// y añade /search, salvo que la ruta ya termine así. El punto de conexión resuelto forma parte de la clave de caché de búsqueda, por lo que los resultados de distintos puntos de conexión nunca se comparten.

Parámetros de la herramienta

querystringrequired

Consulta de búsqueda.

countnumberdefault: 5

Resultados que se devolverán (1-100, sujetos a los límites del tipo de búsqueda de Exa).

Modo de búsqueda.

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

Filtro temporal. No se puede combinar con date_after/date_before.

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 (consulta más abajo).

Extracción de contenido

Pasa un objeto contents para controlar el contenido extraído en los resultados:

javascript

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 generado por IA  },});

Opción de contenido	Tipo	Descripción
`text`	`boolean \| { maxCharacters }`	Extrae el texto completo de la página
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Extrae las frases clave
`summary`	`boolean \| { query }`	Resumen generado por IA

Si se omite contents, Exa utiliza de forma predeterminada { highlights: true }, por lo que los resultados incluyen fragmentos de frases clave. Las descripciones de los resultados se obtienen primero de los fragmentos destacados, después del resumen y, por último, del texto completo, según cuál esté disponible primero. Los resultados también conservan los campos sin procesar highlightScores y summary de la respuesta de la API de Exa cuando están disponibles.

Modos de búsqueda

Modo	Descripción
`auto`	Exa elige el mejor modo (predeterminado)
`neural`	Búsqueda semántica o basada en el 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

count acepta hasta 100, sujeto a los límites del tipo de búsqueda de Exa.
Los resultados se almacenan en caché durante 15 minutos de forma predeterminada. Configura los valores compartidos tools.web.search.cacheTtlMinutes (minutos) y tools.web.search.timeoutSeconds (30 s de forma predeterminada) para cambiar el almacenamiento en caché y el tiempo de espera de las solicitudes de todos los proveedores de web_search, incluido Exa.

Contenido relacionado

Descripción general de la búsqueda web -- todos los proveedores y la detección automática
Brave Search -- resultados estructurados con filtros por país e idioma
Perplexity Search -- resultados estructurados con filtrado por dominio

Was this useful?