Zum Hauptinhalt springen

​
Brave Search API

OpenClaw unterstützt die Brave Search API als web_search-Provider.

​
API-Schlüssel erhalten

  1. Erstellen Sie ein Brave-Search-API-Konto unter https://brave.com/search/api/
  2. Wählen Sie im Dashboard den Tarif Search und generieren Sie einen API-Schlüssel.
  3. Speichern Sie den Schlüssel in der Konfiguration oder setzen Sie BRAVE_API_KEY in der Gateway-Umgebung.

​
Konfigurationsbeispiel

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // oder "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Providerspezifische Brave-Search-Einstellungen befinden sich jetzt unter plugins.entries.brave.config.webSearch.*. Das veraltete tools.web.search.apiKey wird weiterhin über den Kompatibilitäts-Shim geladen, ist jedoch nicht mehr der kanonische Konfigurationspfad. webSearch.mode steuert den Brave-Transport:
  • web (Standard): normale Brave-Websuche mit Titeln, URLs und Snippets
  • llm-context: Brave LLM Context API mit vorab extrahierten Textblöcken und Quellen zur Grounding-Unterstützung

​
Tool-Parameter

ParameterBeschreibung
querySuchanfrage (erforderlich)
countAnzahl der zurückzugebenden Ergebnisse (1-10, Standard: 5)
country2-stelliger ISO-Ländercode (z. B. “US”, “DE”)
languageISO-639-1-Sprachcode für Suchergebnisse (z. B. “en”, “de”, “fr”)
search_langBrave-Code für die Suchsprache (z. B. en, en-gb, zh-hans)
ui_langISO-Sprachcode für UI-Elemente
freshnessZeitfilter: day (24 h), week, month oder year
date_afterNur Ergebnisse, die nach diesem Datum veröffentlicht wurden (YYYY-MM-DD)
date_beforeNur Ergebnisse, die vor diesem Datum veröffentlicht wurden (YYYY-MM-DD)
Beispiele: 
// Länder- und sprachspezifische Suche
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Aktuelle Ergebnisse (letzte Woche)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Suche nach Datumsbereich
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​
Hinweise

  • OpenClaw verwendet den Brave-Tarif Search. Wenn Sie ein veraltetes Abonnement haben (z. B. den ursprünglichen Free-Tarif mit 2.000 Abfragen/Monat), bleibt es gültig, enthält aber keine neueren Funktionen wie LLM Context oder höhere Ratenlimits.
  • Jeder Brave-Tarif enthält $5/Monat an kostenlosem Guthaben (erneuert sich). Der Search-Tarif kostet $5 pro 1.000 Anfragen, daher deckt das Guthaben 1.000 Abfragen/Monat ab. Legen Sie Ihr Nutzungslimit im Brave-Dashboard fest, um unerwartete Kosten zu vermeiden. Aktuelle Tarife finden Sie im Brave-API-Portal.
  • Der Search-Tarif umfasst den LLM-Context-Endpunkt und KI-Inferenzrechte. Das Speichern von Ergebnissen zum Trainieren oder Abstimmen von Modellen erfordert einen Tarif mit ausdrücklichen Speicherrechten. Siehe die Brave-Nutzungsbedingungen.
  • Der Modus llm-context gibt geerdete Quelleneinträge statt der normalen Web-Search-Snippet-Form zurück.
  • Der Modus llm-context unterstützt ui_lang, freshness, date_after oder date_before nicht.
  • ui_lang muss einen Regions-Subtag wie en-US enthalten.
  • Ergebnisse werden standardmäßig 15 Minuten lang zwischengespeichert (konfigurierbar über cacheTtlMinutes).

​
Verwandt