English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Tools

Tavily

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

  • 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 temas, filtros de dominio, resúmenes de respuestas generados por IA y extracción de contenido desde URL (incluidas páginas renderizadas con JavaScript).

Propiedad Valor
Id. del Plugin tavily
Paquete @openclaw/tavily-plugin
Autenticación TAVILY_API_KEY o config apiKey
URL base https://api.tavily.com (predeterminada)
Herramientas tavily_search, tavily_extract

Primeros pasos

  • Instala el Plugin

    bash
    openclaw plugins install @openclaw/tavily-plugin

  • Obtén una clave de API

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

  • Configura 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",      },    },  },}

  • Verifica que la búsqueda se ejecute

    Activa un web_search desde cualquier agente o llama a tavily_search directamente.

    • Referencia de herramientas

    Usa esto cuando quieras controles de búsqueda específicos de Tavily en lugar de web_search genérico.

    Parámetro Tipo Restricciones / predeterminado Descripción
    query string obligatorio Cadena de consulta de búsqueda. Mantenla por debajo de 400 caracteres.
    search_depth enum basic (predeterminado), advanced advanced es más lento, pero ofrece mayor relevancia.
    topic enum general (predeterminado), news, finance Filtra por familia de temas.
    max_results integer 1-20 Número de resultados.
    include_answer boolean predeterminado false Incluye un resumen de respuesta generado por IA de Tavily.
    time_range enum day, week, month, year Filtra los resultados por actualidad.
    include_domains string array (ninguno) Incluye solo resultados de estos dominios.
    exclude_domains string array (ninguno) Excluye resultados de estos dominios.

    Compensación de profundidad de búsqueda:

    Profundidad Velocidad Relevancia Ideal 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 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 centrada en consultas para extracción dirigida.

    Parámetro Tipo Restricciones / predeterminado Descripción
    urls string array obligatorio, 1-20 URL desde las que extraer contenido.
    query string (opcional) Reordena los fragmentos extraídos por relevancia para esta consulta.
    extract_depth enum basic (predeterminado), advanced Usa advanced para páginas con mucho JS, SPA o tablas dinámicas.
    chunks_per_source integer 1-5; requiere query Fragmentos devueltos por URL. Genera errores si se define sin query.
    include_images boolean predeterminado false Incluye URL de imágenes en los resultados.

    Compensación de profundidad de extracción:

    Profundidad Cuándo usarla
    basic Páginas simples. Prueba esto primero.
    advanced SPA renderizadas con JS, contenido dinámico, tablas.

    Elegir la herramienta correcta

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

    tavily_extract genera un error de configuración si ninguno está presente.

    URL base personalizada

    Sobrescribe plugins.entries.tavily.config.webSearch.baseUrl si expones Tavily a través de un proxy. 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 por relevancia de consulta, por lo que el parámetro no tiene sentido sin una.

    Relacionado

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

    On this page