Tools

Exa-Suche

Exa AI ist ein web_search-Provider mit neuronalen, schlüsselwortbasierten und hybriden Suchmodi sowie integrierter Inhaltsextraktion (Hervorhebungen, Text, Zusammenfassungen).

Plugin installieren

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

API-Schlüssel abrufen

Konto erstellen

Registrieren Sie sich bei exa.ai und generieren Sie über Ihr Dashboard einen API-Schlüssel.

Schlüssel speichern

Legen Sie EXA_API_KEY in der Gateway-Umgebung fest oder konfigurieren Sie ihn über:

bash

openclaw configure --section web

Konfiguration

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // optional, wenn EXA_API_KEY festgelegt ist            baseUrl: "https://api.exa.ai", // optional; OpenClaw hängt /search an          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

Alternative über Umgebungsvariable: Legen Sie EXA_API_KEY in der Gateway-Umgebung fest. Bei einer Gateway-Installation tragen Sie die Variable in ~/.openclaw/.env ein. Siehe Umgebungsvariablen.

Basis-URL überschreiben

Legen Sie plugins.entries.exa.config.webSearch.baseUrl fest, um Exa-Suchanfragen über einen kompatiblen Proxy oder einen alternativen Endpunkt zu leiten. OpenClaw normalisiert reine Hostnamen, indem es https:// voranstellt, und hängt /search an, sofern der Pfad nicht bereits damit endet. Der aufgelöste Endpunkt ist Bestandteil des Such-Cache-Schlüssels, sodass Ergebnisse verschiedener Endpunkte niemals gemeinsam verwendet werden.

Tool-Parameter

querystringrequired

Suchanfrage.

countnumberdefault: 5

Anzahl der zurückzugebenden Ergebnisse (1–100, abhängig von den Einschränkungen des Exa-Suchtyps).

Suchmodus.

freshness'day' | 'week' | 'month' | 'year'

Zeitfilter. Kann nicht mit date_after/date_before kombiniert werden.

date_afterstring

Ergebnisse nach diesem Datum (YYYY-MM-DD).

date_beforestring

Ergebnisse vor diesem Datum (YYYY-MM-DD).

contentsobject

Optionen zur Inhaltsextraktion (siehe unten).

Inhaltsextraktion

Übergeben Sie ein contents-Objekt, um die extrahierten Inhalte in den Ergebnissen zu steuern:

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // vollständiger Seitentext    highlights: { numSentences: 3 }, // Schlüsselsätze    summary: true, // KI-Zusammenfassung  },});

Inhaltsoption	Typ	Beschreibung
`text`	`boolean \| { maxCharacters }`	Vollständigen Seitentext extrahieren
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Schlüsselsätze extrahieren
`summary`	`boolean \| { query }`	KI-generierte Zusammenfassung

Wenn contents nicht angegeben wird, verwendet Exa standardmäßig { highlights: true }, sodass die Ergebnisse Auszüge mit Schlüsselsätzen enthalten. Ergebnisbeschreibungen werden zuerst aus Hervorhebungen, dann aus der Zusammenfassung und anschließend aus dem vollständigen Text übernommen – je nachdem, was zuerst verfügbar ist. Die Ergebnisse behalten außerdem die unverarbeiteten Felder highlightScores und summary aus der Antwort der Exa-API bei, sofern diese verfügbar sind.

Suchmodi

Modus	Beschreibung
`auto`	Exa wählt den besten Modus aus (Standard)
`neural`	Semantische beziehungsweise bedeutungsbasierte Suche
`fast`	Schnelle Schlüsselwortsuche
`deep`	Gründliche Tiefensuche
`deep-reasoning`	Tiefensuche mit Schlussfolgerung
`instant`	Schnellste Ergebnisse

Hinweise

count akzeptiert bis zu 100, abhängig von den Einschränkungen des Exa-Suchtyps.
Ergebnisse werden standardmäßig 15 Minuten zwischengespeichert. Konfigurieren Sie die gemeinsamen Optionen tools.web.search.cacheTtlMinutes (Minuten) und tools.web.search.timeoutSeconds (Standardwert: 30 s), um die Cache-Dauer und das Anfrage-Timeout für alle web_search-Provider einschließlich Exa zu ändern.