Pular para o conteúdo principal

​
Tavily

O OpenClaw pode usar o Tavily de duas formas:
  • como provedor de web_search
  • como ferramentas explícitas do plugin: tavily_search e tavily_extract
O Tavily é uma API de pesquisa projetada para aplicações de IA, retornando resultados estruturados otimizados para consumo por LLMs. Ela oferece suporte a profundidade de pesquisa configurável, filtragem por tópico, filtros de domínio, resumos de respostas gerados por IA e extração de conteúdo de URLs (incluindo páginas renderizadas por JavaScript).

​
Obtenha uma chave de API

  1. Crie uma conta do Tavily em tavily.com.
  2. Gere uma chave de API no painel.
  3. Armazene-a na configuração ou defina TAVILY_API_KEY no ambiente do gateway.

​
Configure a pesquisa Tavily

{
  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",
      },
    },
  },
}
Observações:
  • Escolher Tavily no onboarding ou em openclaw configure --section web ativa automaticamente o plugin Tavily incluído.
  • Armazene a configuração do Tavily em plugins.entries.tavily.config.webSearch.*.
  • web_search com Tavily oferece suporte a query e count (até 20 resultados).
  • Para controles específicos do Tavily, como search_depth, topic, include_answer ou filtros de domínio, use tavily_search.

​
Ferramentas do plugin Tavily

Use isto quando quiser controles de pesquisa específicos do Tavily em vez de web_search genérico.
ParâmetroDescrição
queryString de consulta de pesquisa (mantenha abaixo de 400 caracteres)
search_depthbasic (padrão, equilibrado) ou advanced (maior relevância, mais lento)
topicgeneral (padrão), news (atualizações em tempo real) ou finance
max_resultsNúmero de resultados, 1-20 (padrão: 5)
include_answerInclui um resumo de resposta gerado por IA (padrão: false)
time_rangeFiltra por recência: day, week, month ou year
include_domainsArray de domínios para restringir os resultados
exclude_domainsArray de domínios para excluir dos resultados
Profundidade da pesquisa:
ProfundidadeVelocidadeRelevânciaMelhor para
basicMais rápidoAltaConsultas de uso geral (padrão)
advancedMais lentoMáximaPrecisão, fatos específicos, pesquisa

​
tavily_extract

Use isto para extrair conteúdo limpo de uma ou mais URLs. Lida com páginas renderizadas por JavaScript e oferece suporte a segmentação focada em consulta para extração direcionada.
ParâmetroDescrição
urlsArray de URLs para extrair (1-20 por solicitação)
queryReordena os trechos extraídos por relevância para esta consulta
extract_depthbasic (padrão, rápido) ou advanced (para páginas com muito JS)
chunks_per_sourceTrechos por URL, 1-5 (requer query)
include_imagesInclui URLs de imagens nos resultados (padrão: false)
Profundidade da extração:
ProfundidadeQuando usar
basicPáginas simples - tente isto primeiro
advancedSPAs renderizadas por JS, conteúdo dinâmico, tabelas
Dicas:
  • Máximo de 20 URLs por solicitação. Divida listas maiores em várias chamadas.
  • Use query + chunks_per_source para obter apenas o conteúdo relevante em vez de páginas completas.
  • Tente basic primeiro; use advanced se o conteúdo estiver ausente ou incompleto.

​
Escolhendo a ferramenta certa

NecessidadeFerramenta
Pesquisa rápida na web, sem opções especiaisweb_search
Pesquisa com profundidade, tópico, respostas de IAtavily_search
Extrair conteúdo de URLs específicastavily_extract

​
Relacionado