Saltar al contenido principal
Tavily es una API de búsqueda diseñada para aplicaciones de IA. OpenClaw la expone de dos formas:
  • como el 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 de LLM, con profundidad de búsqueda configurable, filtrado por tema, filtros de dominio, resúmenes de respuesta generados por IA y extracción de contenido desde URL (incluidas páginas renderizadas con JavaScript).
PropiedadValor
Id. del Plugintavily
Paquete@openclaw/tavily-plugin
Autenticaciónvariable de entorno TAVILY_API_KEY o configuración apiKey
URL basehttps://api.tavily.com (predeterminada); variable de entorno TAVILY_BASE_URL o configuración baseUrl para sobrescribirla
Tiempos de esperabúsqueda de 30 s, extracción de 60 s (predeterminado)
Herramientastavily_search, tavily_extract

​
Primeros pasos

1

Instalar el Plugin

openclaw plugins install @openclaw/tavily-plugin
2

Obtener una clave de API

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

Configurar 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",
      },
    },
  },
}
4

Verificar que la búsqueda se ejecute

Activa un web_search desde cualquier agente, o llama a tavily_search directamente.
Elegir Tavily durante la incorporación o con openclaw configure --section web instala y habilita el Plugin oficial de Tavily cuando sea necesario.

​
Referencia de herramientas

Úsala cuando quieras controles de búsqueda específicos de Tavily en lugar del web_search genérico.
ParámetroTipoRestricciones / valor predeterminadoDescripción
querystringobligatorioCadena de consulta de búsqueda.
search_depthenumbasic (predeterminado), advancedadvanced es más lento, pero tiene mayor relevancia.
topicenumgeneral (predeterminado), news, financeFiltra por familia de temas.
max_resultsinteger1-20, predeterminado 5Número de resultados.
include_answerbooleanpredeterminado falseIncluye un resumen de respuesta generado por la IA de Tavily.
time_rangeenumday, week, month, yearFiltra los resultados por actualidad.
include_domainsstring array(ninguno)Incluye solo resultados de estos dominios.
exclude_domainsstring array(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

Úsala para extraer contenido limpio de una o más URL. Gestiona páginas renderizadas con JavaScript y admite fragmentación enfocada por consulta para extracción dirigida.
ParámetroTipoRestricciones / valor predeterminadoDescripción
urlsstring arrayobligatorio, 1-20URL de las que extraer contenido.
querystring(opcional)Reordena los fragmentos extraídos por relevancia respecto a esta consulta.
extract_depthenumbasic (predeterminado), advancedUsa advanced para páginas con mucho JS, SPA o tablas dinámicas.
chunks_per_sourceinteger1-5; requiere queryFragmentos devueltos por URL. Produce un error si se establece sin query.
include_imagesbooleanpredeterminado 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, intervalo 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 (resuelto mediante SecretRefs).
  2. TAVILY_API_KEY desde el entorno del Gateway.
Tanto tavily_search como tavily_extract generan un error de configuración si ninguna está presente.
Sobrescribe plugins.entries.tavily.config.webSearch.baseUrl, o establece TAVILY_BASE_URL, si expones Tavily mediante un proxy. La configuración tiene prioridad sobre la variable de entorno. El valor predeterminado es https://api.tavily.com.
tavily_extract rechaza las llamadas que pasan chunks_per_source sin una query. Tavily clasifica los fragmentos por relevancia de consulta, por lo que el parámetro no tiene sentido sin una.

​
Relacionado

Resumen de Web Search

Todos los proveedores y las 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.