Skill Tavily Web Search para OpenClaw

Visão Geral do Skill Tavily Web Search do OpenClaw

O skill Tavily Web Search conecta o OpenClaw à API de Busca do Tavily, um mecanismo de busca otimizado para IA, desenvolvido especificamente para agentes de IA e aplicações LLM. Diferentemente das APIs de busca tradicionais que retornam links brutos, o Tavily analisa múltiplas fontes e retorna conteúdo estruturado e relevante que seu agente OpenClaw pode utilizar imediatamente.

O Tavily é utilizado por mais de 1 milhão de desenvolvedores e processa mais de 100 milhões de requisições por mês. É uma plataforma de confiança da OpenAI, Anthropic, LangChain e outras líderes em IA. Com certificação SOC 2, retenção zero de dados e proteção integrada contra injeção de prompt, é uma das formas mais seguras de dar acesso à web ao seu agente.

Fluxo de trabalho típico:

1. Faça ao OpenClaw uma pergunta que requer informações atualizadas.
2. O agente chama a API do Tavily com uma consulta otimizada.
3. O Tavily pesquisa na web, extrai conteúdo relevante de múltiplas fontes e retorna um resumo estruturado com citações — tudo em menos de 2 segundos.

Este skill é ideal para tarefas de pesquisa, verificação de fatos, consulta de eventos atuais e qualquer fluxo de trabalho em que seu agente precise acessar informações além dos seus dados de treinamento. Ele combina bem com o skill Brave Search para consultas com foco em privacidade e o skill DeepWiki para pesquisa de documentação de repositórios.

Pré-requisitos para o Skill Tavily Web Search

Antes de instalar o skill Tavily Web Search, certifique-se de ter:

• OpenClaw instalado e em execução (v1.0+)
• Uma chave de API do Tavily — cadastre-se em tavily.com (o plano gratuito inclui 1.000 créditos/mês)
• clawhub CLI instalado para gerenciamento de skills

Verifique sua configuração:

# Verificar versão do OpenClaw
openclaw --version

# Confirmar se a chave de API do Tavily está definida
echo $TAVILY_API_KEY

Nenhuma instalação de software adicional é necessária. O skill se comunica com a API na nuvem do Tavily, portanto não há dependências locais além do próprio OpenClaw.

Como Instalar o Skill Tavily Web Search

Instale o skill Tavily Web Search com um único comando:

npx clawhub@latest install tavily-web-search

Para verificar a instalação:

clawhub list

Você deve ver tavily-web-search na lista de skills instalados.

Configuração do Skill Tavily Web Search

O skill requer uma chave de API do Tavily para autenticação. Você pode obter uma chave gratuita em app.tavily.com.

Configuração da chave de API

# Defina sua chave de API do Tavily como variável de ambiente
export TAVILY_API_KEY=tvly-your-api-key-here

Para tornar isso permanente, adicione a linha de exportação ao perfil do seu shell (~/.bashrc, ~/.zshrc ou equivalente).

Modos de busca

O skill suporta duas profundidades de busca e dois modos de tópico que podem ser combinados conforme sua necessidade:

| Modo | Velocidade | Cobertura | Melhor para | |------|-----------|-----------|-------------| | Básico | 1-2 segundos | Boa | Fatos rápidos, consultas simples | | Avançado | 5-10 segundos | Excelente | Pesquisa complexa, respostas abrangentes |

| Tópico | Escopo | Melhor para | |--------|--------|-------------| | Geral | Conteúdo web de todos os tempos | Tópicos permanentes, documentação, tutoriais | | Notícias | Últimos 7 dias, fontes de notícias | Eventos atuais, notícias de última hora, atualizações de mercado |

O agente seleciona automaticamente o modo apropriado com base na sua consulta, mas você pode substituir isso especificando "faça uma busca aprofundada" ou "pesquise notícias recentes" no seu prompt.

Importante: Nunca codifique sua chave de API diretamente em arquivos de configuração ou a envie para o controle de versão. Use variáveis de ambiente ou um gerenciador de segredos como 1Password.

Exemplos de Uso do Skill Tavily Web Search

1. Consulta rápida de fatos

Você: "Qual é a última versão estável do Next.js?"

O agente executa uma busca básica no Tavily, extrai o número da versão de fontes oficiais e retorna uma resposta concisa com um link para as notas de lançamento do Next.js.

2. Pesquisa aprofundada

Você: "Compare os prós e contras da renderização do lado do servidor versus geração de sites estáticos para sites de e-commerce."

O agente realiza uma busca avançada, agrega insights de múltiplos posts de blog, páginas de documentação e estudos de caso, e retorna uma comparação estruturada com citações para cada ponto.

3. Eventos atuais e notícias

Você: "O que aconteceu na indústria de IA esta semana?"

O agente muda para o modo de notícias, pesquisa os últimos 7 dias e retorna um resumo das principais notícias de IA com links para os artigos originais.

4. Pesquisa por domínio específico

Você: "Pesquise apenas no MDN e na documentação do TypeScript sobre como usar template literal types."

O agente usa filtragem por domínio para incluir apenas developer.mozilla.org e typescriptlang.org, garantindo que os resultados venham exclusivamente de fontes autoritativas.

5. Extração de conteúdo

Você: "Extraia o conteúdo completo da página de preços da API do Tavily e resuma os planos."

O agente usa a extração de conteúdo bruto para obter o conteúdo completo da página, depois produz uma análise estruturada de cada plano com recursos e limites.

Segurança e Melhores Práticas

Siga estas diretrizes ao usar o skill Tavily Web Search:

• Proteja sua chave de API. Armazene-a em uma variável de ambiente ou gerenciador de segredos. Nunca a compartilhe em logs de chat, envie para o Git ou exponha em código do lado do cliente.
• Trate os resultados de busca como entrada não confiável. O conteúdo da web pode conter informações imprecisas, desatualizadas ou manipuladas. Sempre verifique fatos críticos em múltiplas fontes antes de agir com base neles. Consulte a Lista de Verificação de Segurança para orientações gerais.
• Monitore seu uso. O plano gratuito fornece 1.000 créditos por mês. Cada busca básica custa 1 crédito, e buscas avançadas custam 2 créditos. Verifique seu uso em app.tavily.com para evitar cobranças inesperadas.
• Use filtragem por domínio para consultas sensíveis. Quando a precisão é importante, restrinja os resultados a domínios confiáveis (documentação oficial, sites governamentais, publicações estabelecidas) usando filtros de inclusão de domínio.
• Esteja atento aos limites de taxa. Evite consultas rápidas em sequência em loops. O skill lida com limitação de taxa de forma elegante, mas requisições excessivas podem restringir temporariamente seu acesso.

Solução de Erros Comuns

"Invalid API key"

Sua chave de API do Tavily está ausente, malformada ou expirada.

1. Verifique se a chave está definida: echo $TAVILY_API_KEY
2. Certifique-se de que ela começa com tvly- — chaves do Tavily sempre usam este prefixo.
3. Se a chave está correta mas ainda falha, gere uma nova em app.tavily.com.

"Rate limit exceeded"

Você excedeu o limite de requisições do seu plano.

1. Verifique seu uso atual em app.tavily.com.
2. Se estiver no plano gratuito, aguarde até a renovação mensal no 1º dia do próximo mês.
3. Considere fazer upgrade para um plano pago para limites mais altos, ou otimize suas consultas para usar o modo básico quando o avançado não for necessário.

"No results found"

A consulta não retornou resultados correspondentes. Isso pode acontecer com buscas muito específicas ou de nicho.

1. Amplie seus termos de busca — remova filtros excessivamente específicos.
2. Se estiver usando filtragem por domínio, certifique-se de que os domínios de destino realmente contêm conteúdo relevante.
3. Tente mudar do modo de notícias para o modo geral se o tópico não for um evento recente.