Skill de Tavily Web Search para OpenClaw

Descripción General del Skill Tavily Web Search de OpenClaw

El skill Tavily Web Search conecta OpenClaw con la API de búsqueda de Tavily, un motor de búsqueda optimizado para IA diseñado específicamente para agentes de IA y aplicaciones LLM. A diferencia de las APIs de búsqueda tradicionales que devuelven enlaces sin procesar, Tavily analiza múltiples fuentes y devuelve contenido estructurado y relevante que tu agente OpenClaw puede utilizar de inmediato.

Tavily impulsa la búsqueda para más de 1 millón de desarrolladores y procesa más de 100 millones de solicitudes al mes. Es utilizado por OpenAI, Anthropic, LangChain y otras plataformas líderes de IA. Con certificación SOC 2, retención de datos cero y protección integrada contra inyección de prompts, es una de las formas más seguras de dar acceso web a tu agente.

Flujo de trabajo típico:

1. Haz a OpenClaw una pregunta que requiera información actualizada.
2. El agente llama a la API de Tavily con una consulta optimizada.
3. Tavily busca en la web, extrae contenido relevante de múltiples fuentes y devuelve un resumen estructurado con citas — todo en menos de 2 segundos.

Este skill es ideal para tareas de investigación, verificación de hechos, consulta de eventos actuales y cualquier flujo de trabajo donde tu agente necesite acceso a información más allá de sus datos de entrenamiento. Se complementa bien con el skill Brave Search para consultas centradas en la privacidad y el skill DeepWiki para investigación de documentación de repositorios.

Requisitos Previos para el Skill Tavily Web Search

Antes de instalar el skill Tavily Web Search, asegúrate de tener:

• OpenClaw instalado y en ejecución (v1.0+)
• Una clave de API de Tavily — regístrate en tavily.com (el plan gratuito incluye 1.000 créditos/mes)
• clawhub CLI instalado para la gestión de skills

Verifica tu configuración:

# Verificar la versión de OpenClaw
openclaw --version

# Confirmar que tu clave de API de Tavily está configurada
echo $TAVILY_API_KEY

No se requiere la instalación de software adicional. El skill se comunica con la API en la nube de Tavily, por lo que no hay dependencias locales más allá del propio OpenClaw.

Cómo Instalar el Skill Tavily Web Search

Instala el skill Tavily Web Search con un solo comando:

npx clawhub@latest install tavily-web-search

Para verificar la instalación:

clawhub list

Deberías ver tavily-web-search en la lista de skills instalados.

Configuración del Skill Tavily Web Search

El skill requiere una clave de API de Tavily para la autenticación. Puedes obtener una clave gratuita en app.tavily.com.

Configuración de la Clave de API

# Configura tu clave de API de Tavily como variable de entorno
export TAVILY_API_KEY=tvly-tu-clave-api-aqui

Para hacerlo permanente, añade la línea de exportación a tu perfil de shell (~/.bashrc, ~/.zshrc o equivalente).

Modos de Búsqueda

El skill admite dos profundidades de búsqueda y dos modos de tema que puedes combinar según tus necesidades:

| Modo | Velocidad | Cobertura | Ideal Para | |------|-----------|-----------|------------| | Básico | 1-2 segundos | Buena | Datos rápidos, consultas simples | | Avanzado | 5-10 segundos | Excelente | Investigación compleja, respuestas exhaustivas |

| Tema | Alcance | Ideal Para | |------|---------|------------| | General | Contenido web de todos los tiempos | Temas permanentes, documentación, tutoriales | | Noticias | Últimos 7 días, fuentes de noticias | Eventos actuales, noticias de última hora, actualizaciones del mercado |

El agente selecciona automáticamente el modo apropiado según tu consulta, pero puedes anularlo especificando "haz una búsqueda profunda" o "busca noticias recientes" en tu prompt.

Importante: Nunca escribas tu clave de API directamente en archivos de configuración ni la subas al control de versiones. Usa variables de entorno o un gestor de secretos como 1Password.

Ejemplos de Uso del Skill Tavily Web Search

1. Consulta Rápida de Datos

Tú: "¿Cuál es la última versión estable de Next.js?"

El agente ejecuta una búsqueda básica de Tavily, extrae el número de versión de fuentes oficiales y devuelve una respuesta concisa con un enlace a las notas de la versión de Next.js.

2. Investigación en Profundidad

Tú: "Compara los pros y contras del renderizado del lado del servidor frente a la generación de sitios estáticos para sitios de comercio electrónico."

El agente realiza una búsqueda avanzada, recopila información de múltiples publicaciones de blogs, páginas de documentación y estudios de caso, y devuelve una comparación estructurada con citas para cada punto.

3. Eventos Actuales y Noticias

Tú: "¿Qué pasó en la industria de la IA esta semana?"

El agente cambia al modo de noticias, busca en los últimos 7 días y devuelve un resumen de las principales noticias de IA con enlaces a los artículos originales.

4. Investigación Específica por Dominio

Tú: "Busca solo en MDN y en la documentación de TypeScript cómo usar tipos de literales de plantilla."

El agente utiliza el filtrado por dominio para incluir solo developer.mozilla.org y typescriptlang.org, asegurando que los resultados provengan exclusivamente de fuentes autorizadas.

5. Extracción de Contenido

Tú: "Extrae el contenido completo de la página de precios de la API de Tavily y resume los niveles."

El agente utiliza la extracción de contenido sin procesar para obtener el contenido completo de la página y luego produce un desglose estructurado de cada nivel de precios con características y límites.

Seguridad y Mejores Prácticas

Sigue estas directrices al usar el skill Tavily Web Search:

• Protege tu clave de API. Guárdala en una variable de entorno o gestor de secretos. Nunca la compartas en registros de chat, la subas a Git ni la expongas en código del lado del cliente.
• Trata los resultados de búsqueda como entrada no confiable. El contenido web puede contener información inexacta, desactualizada o manipulada. Verifica siempre los datos críticos de múltiples fuentes antes de actuar en consecuencia. Consulta la Lista de Verificación de Seguridad para orientación general.
• Monitoriza tu uso. El plan gratuito proporciona 1.000 créditos al mes. Cada búsqueda básica cuesta 1 crédito y las búsquedas avanzadas cuestan 2 créditos. Consulta tu uso en app.tavily.com para evitar excesos inesperados.
• Usa el filtrado por dominio para consultas sensibles. Cuando la precisión importa, restringe los resultados a dominios confiables (documentación oficial, sitios gubernamentales, publicaciones establecidas) usando filtros de inclusión de dominio.
• Ten en cuenta los límites de velocidad. Evita consultas rápidas en bucle. El skill gestiona los límites de velocidad de forma elegante, pero las solicitudes excesivas pueden limitar temporalmente tu acceso.

Solución de Errores Comunes

"Invalid API key"

Tu clave de API de Tavily falta, está mal formada o ha expirado.

1. Verifica que la clave está configurada: echo $TAVILY_API_KEY
2. Asegúrate de que comienza con tvly- — las claves de Tavily siempre usan este prefijo.
3. Si la clave es correcta pero sigue fallando, genera una nueva en app.tavily.com.

"Rate limit exceeded"

Has excedido el límite de solicitudes para tu nivel de plan.

1. Consulta tu uso actual en app.tavily.com.
2. Si estás en el plan gratuito, espera hasta el reinicio mensual el día 1 del próximo mes.
3. Considera actualizar a un plan de pago para obtener límites más altos, u optimiza tus consultas para usar el modo básico donde el avanzado no sea necesario.

"No results found"

La consulta no devolvió resultados coincidentes. Esto puede ocurrir con búsquedas muy específicas o de nicho.

1. Amplía tus términos de búsqueda — elimina filtros demasiado específicos.
2. Si usas filtrado por dominio, asegúrate de que los dominios objetivo realmente contengan contenido relevante.
3. Intenta cambiar del modo de noticias al modo general si el tema no es un evento reciente.