Przejdź do głównej treści
OpenClaw obsługuje Exa AI jako dostawcę web_search. Exa oferuje tryby wyszukiwania neuronowego, słów kluczowych i hybrydowego z wbudowaną ekstrakcją treści (wyróżnienia, tekst, podsumowania).

​
Zainstaluj Plugin

Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway: 
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

​
Uzyskaj klucz API

1

Utwórz konto

Zarejestruj się na exa.ai i wygeneruj klucz API z poziomu panelu.
2

Zapisz klucz

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

​
Konfiguracja

{
  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",
      },
    },
  },
}
Alternatywa środowiskowa: ustaw EXA_API_KEY w środowisku Gateway. W przypadku instalacji Gateway umieść go w ~/.openclaw/.env.

​
Nadpisanie bazowego adresu URL

Ustaw plugins.entries.exa.config.webSearch.baseUrl, gdy żądania wyszukiwania Exa mają przechodzić przez zgodny proxy lub alternatywny punkt końcowy Exa. OpenClaw normalizuje same hosty, dodając na początku https://, i dopisuje /search, chyba że ścieżka już się tam kończy. Rozwiązany punkt końcowy jest uwzględniany w kluczu pamięci podręcznej wyszukiwania, więc wyniki z różnych punktów końcowych Exa nie są współdzielone.

​
Parametry narzędzia

​
query
string
wymagane
Zapytanie wyszukiwania.
​
count
number
Liczba wyników do zwrócenia (1–100).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Tryb wyszukiwania.
​
freshness
'day' | 'week' | 'month' | 'year'
Filtr czasu.
​
date_after
string
Wyniki po tej dacie (YYYY-MM-DD).
​
date_before
string
Wyniki przed tą datą (YYYY-MM-DD).
​
contents
object
Opcje ekstrakcji treści (zobacz poniżej).

​
Ekstrakcja treści

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

​
Tryby wyszukiwania

TrybOpis
autoExa wybiera najlepszy tryb (domyślnie)
neuralWyszukiwanie semantyczne/oparte na znaczeniu
fastSzybkie wyszukiwanie słów kluczowych
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 Exa API, gdy są dostępne
  • Opisy wyników są rozwiązywane najpierw z wyróżnień, potem z podsumowania, a następnie z pełnego tekstu — zależnie od tego, co jest dostępne
  • freshness i date_after/date_before nie mogą być łączone — użyj jednego trybu filtrowania czasu
  • Dla jednego zapytania można zwrócić do 100 wyników (z zastrzeżeniem limitów typu wyszukiwania Exa)
  • Wyniki są domyślnie buforowane przez 15 minut (konfigurowalne przez cacheTtlMinutes)
  • Exa to oficjalna integracja API ze strukturalnymi odpowiedziami JSON

​
Powiązane