Saltar al contenido principal

​
Tavily

OpenClaw puede usar Tavily de dos maneras:
  • como proveedor de web_search
  • como herramientas explícitas del plugin: tavily_search y tavily_extract
Tavily es una API de búsqueda diseñada para aplicaciones de IA, que devuelve resultados estructurados optimizados para el consumo por LLM. Admite profundidad de búsqueda configurable, filtrado por tema, filtros de dominio, resúmenes de respuestas generados por IA y extracción de contenido desde URL (incluidas páginas renderizadas con JavaScript).

​
Obtener una API key

  1. Crea una cuenta de Tavily en tavily.com.
  2. Genera una API key en el panel.
  3. Guárdala en la configuración o establece TAVILY_API_KEY en el entorno del gateway.

​
Configurar la búsqueda de Tavily

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // opcional si TAVILY_API_KEY está configurada
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
Notas:
  • Elegir Tavily durante la incorporación o con openclaw configure --section web activa automáticamente el plugin Tavily integrado.
  • Guarda la configuración de Tavily en plugins.entries.tavily.config.webSearch.*.
  • web_search con Tavily admite query y count (hasta 20 resultados).
  • Para controles específicos de Tavily como search_depth, topic, include_answer o filtros de dominio, usa tavily_search.

​
Herramientas del plugin Tavily

Usa esto cuando quieras controles de búsqueda específicos de Tavily en lugar de web_search genérico.
ParámetroDescripción
queryCadena de consulta de búsqueda (mantenla por debajo de 400 caracteres)
search_depthbasic (predeterminado, equilibrado) o advanced (máxima relevancia, más lento)
topicgeneral (predeterminado), news (actualizaciones en tiempo real) o finance
max_resultsNúmero de resultados, 1-20 (predeterminado: 5)
include_answerIncluye un resumen de respuesta generado por IA (predeterminado: false)
time_rangeFiltra por antigüedad: day, week, month o year
include_domainsArray de dominios a los que restringir los resultados
exclude_domainsArray de dominios que se excluirán de los resultados
Profundidad de búsqueda:
ProfundidadVelocidadRelevanciaIdeal para
basicMás rápidaAltaConsultas de uso general (predeterminado)
advancedMás lentaMáximaPrecisión, hechos específicos, investigación

​
tavily_extract

Usa esto para extraer contenido limpio de una o más URL. Maneja páginas renderizadas con JavaScript y admite fragmentación enfocada en consultas para una extracción dirigida.
ParámetroDescripción
urlsArray de URL que se van a extraer (1-20 por solicitud)
queryReordena los fragmentos extraídos por relevancia para esta consulta
extract_depthbasic (predeterminado, rápido) o advanced (para páginas con mucho JS)
chunks_per_sourceFragmentos por URL, 1-5 (requiere query)
include_imagesIncluye URL de imágenes en los resultados (predeterminado: false)
Profundidad de extracción:
ProfundidadCuándo usarla
basicPáginas simples: prueba esto primero
advancedSPA renderizadas con JS, contenido dinámico, tablas
Consejos:
  • Máximo 20 URL por solicitud. Divide listas más grandes en varias llamadas.
  • Usa query + chunks_per_source para obtener solo contenido relevante en lugar de páginas completas.
  • Prueba primero basic; recurre a advanced si falta contenido o está incompleto.

​
Elegir la herramienta adecuada

NecesidadHerramienta
Búsqueda web rápida, sin opciones especialesweb_search
Búsqueda con profundidad, tema, respuestas de IAtavily_search
Extraer contenido de URL específicastavily_extract

​
Relacionado

  • Resumen de Web Search — todos los proveedores y detección automática
  • Firecrawl — búsqueda + scraping con extracción de contenido
  • Exa Search — búsqueda neuronal con extracción de contenido