Tavily

Tavily es una API de búsqueda diseñada para aplicaciones de IA. OpenClaw la ofrece de dos maneras:

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 de 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 de URL (incluidas páginas renderizadas con JavaScript).

Propiedad	Valor
Id. del plugin	`tavily`
Paquete	`@openclaw/tavily-plugin`
Autenticación	Variable de entorno `TAVILY_API_KEY` o configuración `apiKey`
URL base	`https://api.tavily.com` (predeterminada); variable de entorno `TAVILY_BASE_URL` o configuración `baseUrl` para sustituirla
Tiempos de espera	30s para búsqueda, 60s para extracción (predeterminados)
Herramientas	`tavily_search`, `tavily_extract`

Primeros pasos

Instalar el plugin

openclaw plugins install @openclaw/tavily-plugin

Obtener una clave de API

Cree una cuenta de Tavily en tavily.com y, a continuación, genere una clave de API en el panel.

Configurar el plugin y el proveedor

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // opcional si TAVILY_API_KEY está definida
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

Verificar que la búsqueda se ejecuta

Inicie una web_search desde cualquier agente o llame directamente a tavily_search.

Al elegir Tavily durante la incorporación o en openclaw configure --section web, se instala y habilita el plugin oficial de Tavily cuando es necesario.

Referencia de herramientas

`tavily_search`

Utilice esta opción cuando necesite controles de búsqueda específicos de Tavily en lugar de la herramienta genérica web_search.

Parámetro	Tipo	Restricciones/valor predeterminado	Descripción
`query`	cadena	obligatorio	Cadena de consulta de búsqueda.
`search_depth`	enumeración	`basic` (predeterminado), `advanced`	`advanced` es más lento, pero ofrece mayor relevancia.
`topic`	enumeración	`general` (predeterminado), `news`, `finance`	Filtra por familia temática.
`max_results`	entero	1-20, valor predeterminado: `5`	Número de resultados.
`include_answer`	booleano	valor predeterminado: `false`	Incluye un resumen de respuesta generado por la IA de Tavily.
`time_range`	enumeración	`day`, `week`, `month`, `year`	Filtra los resultados por actualidad.
`include_domains`	matriz de cadenas	(ninguno)	Incluye únicamente resultados de estos dominios.
`exclude_domains`	matriz de cadenas	(ninguno)	Excluye resultados de estos dominios.

Equilibrio de la profundidad de búsqueda:

Profundidad	Velocidad	Relevancia	Uso recomendado
`basic`	Más rápida	Alta	Consultas de propósito general (predeterminado).
`advanced`	Más lenta	Máxima	Investigación precisa y verificación de hechos.

`tavily_extract`

Utilice esta opción para extraer contenido limpio de una o varias URL. Gestiona páginas renderizadas con JavaScript y admite la división en fragmentos centrada en consultas para realizar extracciones específicas.

Parámetro	Tipo	Restricciones/valor predeterminado	Descripción
`urls`	matriz de cadenas	obligatorio, 1-20	URL de las que se extraerá contenido.
`query`	cadena	(opcional)	Reordena los fragmentos extraídos según su relevancia para esta consulta.
`extract_depth`	enumeración	`basic` (predeterminado), `advanced`	Utilice `advanced` para páginas con uso intensivo de JS, SPA o tablas dinámicas.
`chunks_per_source`	entero	1-5; requiere `query`	Fragmentos devueltos por URL. Produce un error si se define sin `query`.
`include_images`	booleano	valor predeterminado: `false`	Incluye las URL de imágenes en los resultados.

Equilibrio de la profundidad de extracción:

Profundidad	Cuándo utilizarla
`basic`	Páginas sencillas. Pruebe primero esta opción.
`advanced`	SPA renderizadas con JS, contenido dinámico y tablas.

Divida las listas de URL más grandes en varias llamadas a tavily_extract (máximo de 20 por solicitud). Utilice query junto con chunks_per_source para obtener solo el contenido relevante en lugar de páginas completas.

Elegir la herramienta adecuada

Necesidad	Herramienta
Búsqueda web rápida, sin opciones especiales	`web_search`
Búsqueda con profundidad, tema y respuestas de IA	`tavily_search`
Extraer contenido de URL específicas	`tavily_extract`

La herramienta genérica web_search con Tavily como proveedor admite query y count (hasta 20 resultados). Para utilizar controles específicos de Tavily (search_depth, topic, include_answer, filtros de dominio e intervalo de tiempo), utilice tavily_search.

Configuración avanzada

Orden de resolución de la clave de API

El cliente de Tavily busca su clave de API en este orden:

plugins.entries.tavily.config.webSearch.apiKey (resuelta mediante SecretRefs).
TAVILY_API_KEY del entorno del Gateway.

Tanto tavily_search como tavily_extract generan un error de configuración si no se encuentra ninguna.

URL base personalizada

Sustituya plugins.entries.tavily.config.webSearch.baseUrl o defina TAVILY_BASE_URL si se accede a Tavily mediante un proxy. La configuración tiene prioridad sobre la variable de entorno. El valor predeterminado es https://api.tavily.com.

`chunks_per_source` requiere `query`

tavily_extract rechaza las llamadas que pasan chunks_per_source sin una query. Tavily ordena los fragmentos según su relevancia para la consulta, por lo que el parámetro carece de sentido sin una.

Temas relacionados

Descripción general de la búsqueda web

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

Firecrawl

Búsqueda y extracción web con extracción de contenido.

Búsqueda con Exa

Búsqueda neuronal con extracción de contenido.

Configuración

Esquema de configuración completo para las entradas de plugins y el enrutamiento de herramientas.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Primeros pasos

Referencia de herramientas

`tavily_search`

`tavily_extract`

Elegir la herramienta adecuada

Configuración avanzada

Temas relacionados

Descripción general de la búsqueda web

Firecrawl

Búsqueda con Exa

Configuración

​Primeros pasos

​Referencia de herramientas

​tavily_search

​tavily_extract

​Elegir la herramienta adecuada

​Configuración avanzada

​Temas relacionados

Descripción general de la búsqueda web

Firecrawl

Búsqueda con Exa

Configuración

Primeros pasos

Referencia de herramientas

`tavily_search`

`tavily_extract`

Elegir la herramienta adecuada

Configuración avanzada

Temas relacionados