web_search com modos de busca neural, por palavras-chave e
híbrida, além de extração de conteúdo integrada (destaques, texto,
resumos).
Instalar o Plugin
Obter uma chave de API
1
Criar uma conta
Cadastre-se em exa.ai e gere uma chave de API no seu
painel.
2
Armazenar a chave
Defina
EXA_API_KEY no ambiente do Gateway ou configure por meio de:Configuração
EXA_API_KEY no ambiente do Gateway. Para
uma instalação do Gateway, coloque-a em ~/.openclaw/.env. Consulte
Variáveis de ambiente.
Substituição da URL base
Definaplugins.entries.exa.config.webSearch.baseUrl para encaminhar as
solicitações de busca do Exa por um proxy compatível ou endpoint alternativo. O OpenClaw
normaliza hosts sem protocolo, prefixando-os com https://, e acrescenta /search, a menos que
o caminho já termine assim. O endpoint resolvido faz parte da chave do cache
de busca, portanto os resultados de endpoints diferentes nunca são compartilhados.
Parâmetros da ferramenta
string
obrigatório
Consulta de busca.
number
padrão:"5"
Resultados a retornar (1–100, sujeito aos limites do tipo de busca do Exa).
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Modo de busca.
'day' | 'week' | 'month' | 'year'
Filtro de tempo. Não pode ser combinado com
date_after/date_before.string
Resultados posteriores a esta data (
YYYY-MM-DD).string
Resultados anteriores a esta data (
YYYY-MM-DD).object
Opções de extração de conteúdo (consulte abaixo).
Extração de conteúdo
Passe um objetocontents para controlar o conteúdo extraído nos resultados:
Se
contents for omitido, o padrão do Exa será { highlights: true }, para que os resultados
incluam trechos com frases principais. As descrições dos resultados são obtidas primeiro dos destaques,
depois do resumo e, por fim, do texto completo — usando o primeiro que estiver disponível. Os resultados
também preservam os campos brutos highlightScores e summary da resposta da API do Exa,
quando disponíveis.
Modos de busca
Observações
countaceita até 100, sujeito aos limites do tipo de busca do Exa.- Por padrão, os resultados ficam armazenados em cache por 15 minutos. Configure os parâmetros compartilhados
tools.web.search.cacheTtlMinutes(minutos) etools.web.search.timeoutSeconds(padrão de 30 s) para alterar o cache e o tempo limite das solicitações de todos os provedores deweb_search, incluindo o Exa.
Relacionados
- Visão geral da busca na Web — todos os provedores e detecção automática
- Brave Search — resultados estruturados com filtros de país/idioma
- Perplexity Search — resultados estruturados com filtragem por domínio