Tools

Pesquisa Exa

Exa AI é um provedor de 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

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

Obter uma chave de API

Criar uma conta

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

Armazenar a chave

Defina EXA_API_KEY no ambiente do Gateway ou configure por meio de:

bash

openclaw configure --section web

Configuração

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // opcional se EXA_API_KEY estiver definida            baseUrl: "https://api.exa.ai", // opcional; o OpenClaw acrescenta /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

Alternativa por variável de ambiente: defina 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

Defina plugins.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

querystringrequired

Consulta de busca.

countnumberdefault: 5

Resultados a retornar (1–100, sujeito aos limites do tipo de busca do Exa).

Modo de busca.

freshness'day' | 'week' | 'month' | 'year'

Filtro de tempo. Não pode ser combinado com date_after/date_before.

date_afterstring

Resultados posteriores a esta data (YYYY-MM-DD).

date_beforestring

Resultados anteriores a esta data (YYYY-MM-DD).

contentsobject

Opções de extração de conteúdo (consulte abaixo).

Extração de conteúdo

Passe um objeto contents para controlar o conteúdo extraído nos resultados:

javascript

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 gerado por IA  },});

Opção de conteúdo	Tipo	Descrição
`text`	`boolean \| { maxCharacters }`	Extrai o texto completo da página
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Extrai as frases principais
`summary`	`boolean \| { query }`	Resumo gerado por IA

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

Modo	Descrição
`auto`	O Exa escolhe o melhor modo (padrão)
`neural`	Busca semântica/baseada em significado
`fast`	Busca rápida por palavras-chave
`deep`	Busca aprofundada e abrangente
`deep-reasoning`	Busca aprofundada com raciocínio
`instant`	Resultados mais rápidos

Observações

count aceita 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) e tools.web.search.timeoutSeconds (padrão de 30 s) para alterar o cache e o tempo limite das solicitações de todos os provedores de web_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

Was this useful?