---
read_when:
- Quieres búsqueda web respaldada por Tavily
- Necesitas una clave de API de Tavily
- Quieres Tavily como proveedor de web_search
- Quieres extraer contenido de URLs
summary: Herramientas de búsqueda y extracción de Tavily
title: Tavily
x-i18n:
generated_at: "2026-06-27T13:10:29Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: 539e76120e858129dabfb85c1fe379837fc87be491d5a57803917bf6bb7018ae
source_path: tools/tavily.md
workflow: 16
---
[Tavily](https://tavily.com) 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
```bash
openclaw plugins install @openclaw/tavily-plugin
```
Crea una cuenta de Tavily en [tavily.com](https://tavily.com) y luego genera una clave de API en el panel.
```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",
},
},
},
}
```
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 es necesario.
## Referencia de herramientas
### `tavily_search`
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. |
Divide listas de URL más grandes en varias llamadas a `tavily_extract` (máx. 20 por solicitud). Usa `query` junto con `chunks_per_source` para obtener solo contenido relevante en lugar de páginas completas.
## 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` |
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, rango 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` (resuelta mediante SecretRefs).
2. `TAVILY_API_KEY` desde el entorno del Gateway.
`tavily_extract` genera un error de configuración si ninguno está presente.
Sobrescribe `plugins.entries.tavily.config.webSearch.baseUrl` si expones Tavily a través de un proxy. 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
Todos los proveedores y reglas de detección automática.
Búsqueda más scraping con extracción de contenido.
Búsqueda neuronal con extracción de contenido.
Esquema de configuración completo para entradas de Plugin y enrutamiento de herramientas.