Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Create an account

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

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

query
string
requerido
Consulta de búsqueda.
count
number
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_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 (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 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

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 y exhaustiva
deep-reasoningBúsqueda profunda con razonamiento
instantResultados 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