Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw oferece suporte à Exa AI como provedor de web_search. A Exa oferece modos de busca neural, por palavra-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 via:
openclaw configure --section web

​
Configuração

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // optional if EXA_API_KEY is set
            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
Alternativa de ambiente: defina EXA_API_KEY no ambiente do Gateway. Para uma instalação do Gateway, coloque-a em ~/.openclaw/.env.

​
Substituição da URL base

Defina plugins.entries.exa.config.webSearch.baseUrl quando as solicitações de busca da Exa devem passar por um proxy compatível ou por um endpoint alternativo da Exa. O OpenClaw normaliza hosts simples prefixando https:// e acrescenta /search, a menos que o caminho já termine assim. O endpoint resolvido é incluído na chave de cache de busca, portanto resultados de endpoints diferentes da Exa não são compartilhados.

​
Parâmetros da ferramenta

​
query
string
obrigatório
Consulta de busca.
​
count
number
Resultados a retornar (1–100).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Modo de busca.
​
freshness
'day' | 'week' | 'month' | 'year'
Filtro de tempo.
​
date_after
string
Resultados após esta data (YYYY-MM-DD).
​
date_before
string
Resultados antes desta data (YYYY-MM-DD).
​
contents
object
Opções de extração de conteúdo (veja abaixo).

​
Extração de conteúdo

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

​
Modos de busca

ModoDescrição
autoA Exa escolhe o melhor modo (padrão)
neuralBusca semântica/baseada em significado
fastBusca rápida por palavra-chave
deepBusca profunda e completa
deep-reasoningBusca profunda com raciocínio
instantResultados mais rápidos

​
Observações

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

​
Relacionado