OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

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 por parte de LLM, con profundidad de búsqueda configurable, filtrado por tema, filtros de dominios, 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 reemplazarla
Tiempos de espera 30 s para búsquedas, 60 s para extracciones (predeterminados)
Herramientas tavily_search, tavily_extract

Primeros pasos

  • Instalar el Plugin

    bash
    openclaw plugins install @openclaw/tavily-plugin

  • Obtener una clave de API

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

  • Configurar el Plugin y el proveedor

    json5
    {  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",      },    },  },}

  • Verificar que se ejecuten las búsquedas

    Activa una llamada a web_search desde cualquier agente o llama directamente a tavily_search.

    • Referencia de herramientas

    Utiliza esta herramienta cuando quieras 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 los resultados de estos dominios.

    Equilibrio de la profundidad de búsqueda:

    Profundidad Velocidad Relevancia Opción recomendada para
    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 datos.

    tavily_extract

    Utiliza esta herramienta para extraer contenido limpio de una o varias URL. Gestiona páginas renderizadas con JavaScript y admite la división en fragmentos centrada en una consulta 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 Utiliza advanced para páginas con mucho JS, SPA o tablas dinámicas.
    chunks_per_source entero 1-5; requiere query Fragmentos devueltos por URL. Produce un error si se establece sin query.
    include_images booleano valor predeterminado false Incluye URL de imágenes en los resultados.

    Equilibrio de la profundidad de extracción:

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

    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

    Configuración avanzada

    Orden de resolución de la clave de API

    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 del entorno del Gateway.

    Tanto tavily_search como tavily_extract generan un error de configuración si ninguna de las dos está presente.

    URL base personalizada

    Reemplaza plugins.entries.tavily.config.webSearch.baseUrl o establece TAVILY_BASE_URL si accedes 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 clasifica los fragmentos según su relevancia para la consulta, por lo que el parámetro carece de sentido sin ella.

    Contenido relacionado

    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.
    Was this useful?
    On this page

    On this page