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 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

    bash
    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

    json5
    {  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.

    • Referencia de herramientas

    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.

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

    On this page