Saltar al contenido principal
Exa AI es un proveedor de web_search con modos de búsqueda neural, por palabra clave e híbrida, además de extracción de contenido integrada (resaltados, texto, resúmenes).

​
Instalar Plugin

openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

​
Obtener una clave de API

1

Crear una cuenta

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

Guardar la clave

Define 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: define EXA_API_KEY en el entorno del Gateway. Para una instalación de gateway, colócalo en ~/.openclaw/.env. Consulta variables de entorno.

​
Sobrescritura de URL base

Define plugins.entries.exa.config.webSearch.baseUrl para enrutar las solicitudes de búsqueda de Exa a través de un proxy compatible o un endpoint alternativo. OpenClaw normaliza hosts sin esquema anteponiendo https:// y añade /search a menos que la ruta ya termine ahí. El endpoint resuelto forma parte de la clave de caché de búsqueda, por lo que los resultados de endpoints distintos nunca se comparten.

​
Parámetros de herramienta

​
query
string
requerido
Consulta de búsqueda.
​
count
number
predeterminado:"5"
Resultados que devolver (1-100, sujeto a los límites de tipo de búsqueda de Exa).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Modo de búsqueda.
​
freshness
'day' | 'week' | 'month' | 'year'
Filtro temporal. No puede combinarse con date_after/date_before.
​
date_after
string
Resultados posteriores a esta fecha (YYYY-MM-DD).
​
date_before
string
Resultados anteriores a esta fecha (YYYY-MM-DD).
​
contents
object
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: 
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 contentsTipoDescripción
textboolean | { maxCharacters }Extraer texto completo de la página
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Extraer frases clave
summaryboolean | { query }Resumen generado por IA
Si se omite contents, Exa usa de forma predeterminada { highlights: true }, por lo que los resultados incluyen extractos de frases clave. Las descripciones de los resultados se resuelven a partir de los resaltados primero, luego del resumen y luego del texto completo, lo que esté disponible primero. Los resultados también preservan los campos highlightScores y summary sin procesar de la respuesta de la API de Exa cuando están disponibles.

​
Modos de búsqueda

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

​
Notas

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

​
Relacionado