Pular para o conteúdo principal

​
Busca Exa

O OpenClaw oferece suporte ao Exa AI como provider de web_search. O Exa oferece modos de busca neural, por palavras-chave e híbrida com extração de conteúdo integrada (destaques, texto, resumos).

​
Obtenha uma chave de API

1

Crie uma conta

Cadastre-se em exa.ai e gere uma chave de API no seu painel.
2

Armazene a chave

Defina EXA_API_KEY no ambiente do Gateway ou configure por meio de:
openclaw configure --section web

​
Configuração

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // opcional se EXA_API_KEY estiver definida
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
Alternativa por ambiente: defina EXA_API_KEY no ambiente do Gateway. Para uma instalação de gateway, coloque-a em ~/.openclaw/.env.

​
Parâmetros da ferramenta

ParâmetroDescrição
queryConsulta de busca (obrigatório)
countResultados a retornar (1-100)
typeModo de busca: auto, neural, fast, deep, deep-reasoning ou instant
freshnessFiltro de tempo: day, week, month ou year
date_afterResultados após esta data (YYYY-MM-DD)
date_beforeResultados antes desta data (YYYY-MM-DD)
contentsOpções de extração de conteúdo (veja abaixo)

​
Extração de conteúdo

O Exa pode retornar conteúdo extraído junto com os resultados da busca. Passe um objeto contents para ativar: 
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // texto completo da página
    highlights: { numSentences: 3 }, // frases principais
    summary: true, // resumo por IA
  },
});
Opção de contentsTipoDescrição
textboolean | { maxCharacters }Extrai o texto completo da página
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Extrai frases principais
summaryboolean | { query }Resumo gerado por IA

​
Modos de busca

ModoDescrição
autoO Exa escolhe o melhor modo (padrão)
neuralBusca semântica/baseada em significado
fastBusca rápida por palavras-chave
deepBusca profunda detalhada
deep-reasoningBusca profunda com reasoning
instantResultados mais rápidos

​
Observações

  • Se nenhuma opção contents for fornecida, o Exa usa por padrão { highlights: true } para que os resultados incluam trechos com frases principais
  • Os resultados preservam os campos highlightScores e summary da resposta da API Exa quando disponíveis
  • As descrições dos resultados são resolvidas primeiro a partir de destaques, depois de resumo e por fim de texto completo — o que estiver disponível
  • freshness e date_after/date_before não podem ser combinados — use um único modo de filtro temporal
  • Até 100 resultados podem ser retornados por consulta (sujeito aos limites do tipo de busca do Exa)
  • Os resultados são armazenados em cache por 15 minutos por padrão (configurável por meio de cacheTtlMinutes)
  • O Exa é uma integração oficial de API com respostas JSON estruturadas

​
Relacionados