Przejdź do głównej treści

Exa Search

OpenClaw obsługuje Exa AI jako providera web_search. Exa oferuje tryby wyszukiwania neuronowego, słowami kluczowymi i hybrydowego z wbudowaną ekstrakcją treści (wyróżnienia, tekst, podsumowania).

Pobierz klucz API

1

Utwórz konto

Zarejestruj się na exa.ai i wygeneruj klucz API w swoim panelu.
2

Zapisz klucz

Ustaw EXA_API_KEY w środowisku Gateway albo skonfiguruj przez:
openclaw configure --section web

Konfiguracja

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // opcjonalne, jeśli ustawiono EXA_API_KEY
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
Alternatywa środowiskowa: ustaw EXA_API_KEY w środowisku Gateway. W przypadku instalacji gateway umieść ją w ~/.openclaw/.env.

Parametry narzędzia

ParametrOpis
queryZapytanie wyszukiwania (wymagane)
countLiczba wyników do zwrócenia (1-100)
typeTryb wyszukiwania: auto, neural, fast, deep, deep-reasoning lub instant
freshnessFiltr czasu: day, week, month lub year
date_afterWyniki po tej dacie (YYYY-MM-DD)
date_beforeWyniki przed tą datą (YYYY-MM-DD)
contentsOpcje ekstrakcji treści (zobacz poniżej)

Ekstrakcja treści

Exa może zwracać wyodrębnioną treść obok wyników wyszukiwania. Przekaż obiekt contents, aby ją włączyć:
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // pełny tekst strony
    highlights: { numSentences: 3 }, // kluczowe zdania
    summary: true, // podsumowanie AI
  },
});
Opcja contentsTypOpis
textboolean | { maxCharacters }Wyodrębnij pełny tekst strony
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Wyodrębnij kluczowe zdania
summaryboolean | { query }Podsumowanie generowane przez AI

Tryby wyszukiwania

TrybOpis
autoExa wybiera najlepszy tryb (domyślnie)
neuralWyszukiwanie semantyczne/oparte na znaczeniu
fastSzybkie wyszukiwanie słowami kluczowymi
deepDokładne głębokie wyszukiwanie
deep-reasoningGłębokie wyszukiwanie z rozumowaniem
instantNajszybsze wyniki

Uwagi

  • Jeśli nie podano opcji contents, Exa domyślnie używa { highlights: true }, więc wyniki zawierają fragmenty kluczowych zdań
  • Wyniki zachowują pola highlightScores i summary z odpowiedzi API Exa, gdy są dostępne
  • Opisy wyników są rozwiązywane najpierw z highlights, potem z summary, a następnie z pełnego tekstu — zależnie od tego, co jest dostępne
  • freshness oraz date_after/date_before nie mogą być używane łącznie — użyj jednego trybu filtrowania czasu
  • Na jedno zapytanie można zwrócić do 100 wyników (z zastrzeżeniem limitów typu wyszukiwania Exa)
  • Wyniki są domyślnie buforowane przez 15 minut (można to skonfigurować przez cacheTtlMinutes)
  • Exa to oficjalna integracja API ze strukturalnymi odpowiedziami JSON

Powiązane