Tools

Pesquisa Exa

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

  • Crie uma conta

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

  • 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

    querystringrequired

    Consulta de busca.

    countnumber

    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_afterstring

    Resultados após esta data (YYYY-MM-DD).

    date_beforestring

    Resultados antes desta data (YYYY-MM-DD).

    contentsobject

    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údo Tipo Descrição
    text boolean | { maxCharacters } Extrair texto completo da página
    highlights boolean | { maxCharacters, query, numSentences, highlightsPerUrl } Extrair frases principais
    summary boolean | { query } Resumo gerado por IA

    Modos de busca

    Modo Descrição
    auto A Exa escolhe o melhor modo (padrão)
    neural Busca semântica/baseada em significado
    fast Busca rápida por palavra-chave
    deep Busca profunda e completa
    deep-reasoning Busca profunda com raciocínio
    instant Resultados 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