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.

Tavily es una API de búsqueda diseñada para aplicaciones de IA. OpenClaw la expone de dos formas:
  • como proveedor web_search para la herramienta de búsqueda genérica
  • como herramientas explícitas del Plugin: tavily_search y tavily_extract
Tavily devuelve resultados estructurados optimizados para el consumo por LLM, con 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).
PropiedadValor
ID del Plugintavily
AutenticaciónTAVILY_API_KEY o config apiKey
URL basehttps://api.tavily.com (predeterminada)
Herramientas incluidastavily_search, tavily_extract

​
Primeros pasos

1

Obtén una clave de API

Crea una cuenta de Tavily en tavily.com y luego genera una clave de API en el panel.
2

Configura el Plugin y el proveedor

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
3

Verifica que la búsqueda se ejecute

Activa una web_search desde cualquier agente, o llama directamente a tavily_search.
Elegir Tavily durante la incorporación o con openclaw configure --section web habilita automáticamente el Plugin de Tavily incluido.

​
Referencia de herramientas

Usa esto cuando quieras controles de búsqueda específicos de Tavily en lugar de web_search genérico.
ParámetroTipoRestricciones / predeterminadoDescripción
querycadenaobligatorioCadena de consulta de búsqueda. Mantenla por debajo de 400 caracteres.
search_depthenumbasic (predeterminado), advancedadvanced es más lento, pero tiene mayor relevancia.
topicenumgeneral (predeterminado), news, financeFiltra por familia temática.
max_resultsentero1-20Número de resultados.
include_answerbooleanopredeterminado falseIncluye un resumen de respuesta generado por IA de Tavily.
time_rangeenumday, week, month, yearFiltra resultados por actualidad.
include_domainsarray de cadenas(ninguno)Incluye solo resultados de estos dominios.
exclude_domainsarray de cadenas(ninguno)Excluye resultados de estos dominios.
Compensación de profundidad de búsqueda:
ProfundidadVelocidadRelevanciaIdeal para
basicMás rápidaAltaConsultas de propósito general (predeterminado).
advancedMás lentaMáximaInvestigación precisa y verificación de hechos.

​
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 extracción dirigida.
ParámetroTipoRestricciones / predeterminadoDescripción
urlsarray de cadenasobligatorio, 1-20URL de las que extraer contenido.
querycadena(opcional)Reordena los fragmentos extraídos por relevancia para esta consulta.
extract_depthenumbasic (predeterminado), advancedUsa advanced para páginas con mucho JS, SPA o tablas dinámicas.
chunks_per_sourceentero1-5; requiere queryFragmentos devueltos por URL. Da error si se establece sin query.
include_imagesbooleanopredeterminado falseIncluye URL de imágenes en los resultados.
Compensación de profundidad de extracción:
ProfundidadCuándo usarla
basicPáginas simples. Prueba esto primero.
advancedSPA renderizadas con JS, contenido dinámico, tablas.
Divide listas de URL más grandes en varias llamadas a tavily_extract (máximo 20 por solicitud). Usa query junto con chunks_per_source para obtener solo contenido relevante en lugar de páginas completas.

​
Elegir la herramienta adecuada

NecesidadHerramienta
Búsqueda web rápida, sin opciones especialesweb_search
Búsqueda con profundidad, tema y respuestas de IAtavily_search
Extraer contenido de URL específicastavily_extract
La herramienta genérica web_search con Tavily como proveedor admite query y count (hasta 20 resultados). Para controles específicos de Tavily (search_depth, topic, include_answer, filtros de dominio, rango de tiempo), usa tavily_search en su lugar.

​
Configuración avanzada

El cliente de Tavily busca su clave de API en este orden:
  1. plugins.entries.tavily.config.webSearch.apiKey (resuelta mediante SecretRefs).
  2. TAVILY_API_KEY desde el entorno del Gateway.
tavily_extract genera un error de configuración si no está presente ninguna de las dos.
Sobrescribe plugins.entries.tavily.config.webSearch.baseUrl si expones Tavily mediante un proxy. El valor predeterminado es https://api.tavily.com.
tavily_extract rechaza llamadas que pasen chunks_per_source sin una query. Tavily clasifica los fragmentos por relevancia respecto de la consulta, por lo que el parámetro no tiene sentido sin una.

​
Relacionado

Descripción general de Web Search

Todos los proveedores y reglas de detección automática.

Firecrawl

Búsqueda más scraping con extracción de contenido.

Exa Search

Búsqueda neuronal con extracción de contenido.

Configuración

Esquema de configuración completo para entradas de Plugin y enrutamiento de herramientas.