Przejdź do głównej treści

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 obsługuje Exa AI jako dostawcę web_search. Exa oferuje neuronowe, słowokluczowe i hybrydowe tryby wyszukiwania z wbudowaną ekstrakcją treści (wyróżnienia, tekst, podsumowania).

Uzyskaj 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 za pomocą:
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 serwer proxy lub alternatywny punkt końcowy Exa. OpenClaw normalizuje same hosty, dodając na początku https://, i dodaje /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
Wyniki 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 niż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, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});
Opcja zawartościTypOpis
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ń, następnie z podsumowania, a potem z pełnego tekstu — zależnie od tego, co jest dostępne
  • freshness oraz date_after/date_before nie mogą być łączone — 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 (konfigurowalne przez cacheTtlMinutes)
  • Exa to oficjalna integracja API ze strukturalnymi odpowiedziami JSON

Powiązane