Pular para o conteúdo principal
Tavily é uma API de busca projetada para aplicações de IA. O OpenClaw a expõe de duas formas:
  • como o provedor web_search para a ferramenta de busca genérica
  • como ferramentas explícitas de Plugin: tavily_search e tavily_extract
O Tavily retorna resultados estruturados otimizados para consumo por LLMs, com profundidade de busca 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).
PropriedadeValor
ID do Plugintavily
Pacote@openclaw/tavily-plugin
AuthTAVILY_API_KEY ou configuração apiKey
URL basehttps://api.tavily.com (padrão)
Ferramentastavily_search, tavily_extract

​
Primeiros passos

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

Crie uma conta Tavily em tavily.com e então gere uma chave de API no painel.
3

Configure the plugin and provider

{
  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",
      },
    },
  },
}
4

Verify search runs

Acione um web_search de qualquer agente ou chame tavily_search diretamente.
Escolher Tavily na integração inicial ou em openclaw configure --section web instala e habilita o Plugin oficial do Tavily quando necessário.

​
Referência de ferramentas

Use isto quando quiser controles de busca específicos do Tavily em vez do web_search genérico.
ParâmetroTipoRestrições / padrãoDescrição
querystringobrigatórioString de consulta de busca. Mantenha abaixo de 400 caracteres.
search_depthenumbasic (padrão), advancedadvanced é mais lento, mas tem maior relevância.
topicenumgeneral (padrão), news, financeFiltra por família de tópicos.
max_resultsinteger1-20Número de resultados.
include_answerbooleanpadrão falseInclui um resumo de resposta gerado por IA do Tavily.
time_rangeenumday, week, month, yearFiltra resultados por recência.
include_domainsarray de strings(nenhum)Inclui apenas resultados destes domínios.
exclude_domainsarray de strings(nenhum)Exclui resultados destes domínios.
Tradeoff de profundidade de busca:
ProfundidadeVelocidadeRelevânciaMelhor para
basicMais rápidoAltaConsultas de uso geral (padrão).
advancedMais lentoMáximaPesquisa precisa e verificação de fatos.

​
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 divisão em chunks focada em consulta para extração direcionada.
ParâmetroTipoRestrições / padrãoDescrição
urlsarray de stringsobrigatório, 1-20URLs das quais extrair conteúdo.
querystring(opcional)Reordena chunks extraídos por relevância para esta consulta.
extract_depthenumbasic (padrão), advancedUse advanced para páginas pesadas em JS, SPAs ou tabelas dinâmicas.
chunks_per_sourceinteger1-5; requer queryChunks retornados por URL. Gera erro se definido sem query.
include_imagesbooleanpadrão falseInclui URLs de imagens nos resultados.
Tradeoff de profundidade de extração:
ProfundidadeQuando usar
basicPáginas simples. Tente isto primeiro.
advancedSPAs renderizadas por JS, conteúdo dinâmico, tabelas.
Divida listas maiores de URLs em várias chamadas tavily_extract (máximo de 20 por solicitação). Use query mais chunks_per_source para obter apenas conteúdo relevante em vez de páginas completas.

​
Escolhendo a ferramenta certa

NecessidadeFerramenta
Busca web rápida, sem opções especiaisweb_search
Busca com profundidade, tópico, respostas de IAtavily_search
Extrair conteúdo de URLs específicastavily_extract
A ferramenta genérica web_search com Tavily como provedor oferece suporte a query e count (até 20 resultados). Para controles específicos do Tavily (search_depth, topic, include_answer, filtros de domínio, intervalo de tempo), use tavily_search.

​
Configuração avançada

O cliente Tavily procura sua chave de API nesta ordem:
  1. plugins.entries.tavily.config.webSearch.apiKey (resolvida por SecretRefs).
  2. TAVILY_API_KEY do ambiente do Gateway.
tavily_extract gera um erro de configuração se nenhum dos dois estiver presente.
Substitua plugins.entries.tavily.config.webSearch.baseUrl se você expõe o Tavily por meio de um proxy. O padrão é https://api.tavily.com.
tavily_extract rejeita chamadas que passam chunks_per_source sem uma query. O Tavily classifica chunks por relevância da consulta, portanto o parâmetro não tem significado sem uma.

​
Relacionado

Web Search overview

Todos os provedores e regras de detecção automática.

Firecrawl

Busca mais scraping com extração de conteúdo.

Exa Search

Busca neural com extração de conteúdo.

Configuration

Esquema de configuração completo para entradas de Plugin e roteamento de ferramentas.