OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Brave-Suche

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

API-Schlüssel abrufen

  1. Erstellen Sie unter https://brave.com/search/api/ ein Brave-Search-API-Konto.
  2. Wählen Sie im Dashboard den Tarif Search aus 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

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // oder "llm-context"            baseUrl: "https://api.search.brave.com", // optionale Überschreibung der Proxy-/Basis-URL          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Provider-spezifische Einstellungen für die Brave-Suche befinden sich unter plugins.entries.brave.config.webSearch.*; dies ist der kanonische Konfigurationspfad. Ein gemeinsam genutztes tools.web.search.apiKey auf oberster Ebene und ein bereichsspezifisches tools.web.search.brave.* werden weiterhin über eine Kompatibilitätszusammenführung geladen, neue Konfigurationen sollten jedoch den oben genannten Plugin-spezifischen Pfad verwenden.

webSearch.mode steuert den Brave-Transport:

  • web (Standard): normale Brave-Websuche mit Titeln, URLs und Auszügen
  • llm-context: Brave LLM Context API mit vorab extrahierten Textabschnitten und Quellen zur Fundierung

webSearch.baseUrl kann Brave-Anfragen an einen vertrauenswürdigen, Brave-kompatiblen Proxy oder ein Gateway weiterleiten. OpenClaw hängt /res/v1/web/search oder /res/v1/llm/context an die konfigurierte Basis-URL an und berücksichtigt die Basis-URL im Cache-Schlüssel. Öffentliche Endpunkte müssen https:// verwenden; http:// wird nur für vertrauenswürdige local loopback- oder Proxy-Hosts in privaten Netzwerken akzeptiert.

Tool-Parameter

querystringrequired

Suchanfrage.

countnumberdefault: 5

Anzahl der zurückzugebenden Ergebnisse (1–10).

countrystring

Zweistelliger ISO-Ländercode (z. B. US, DE).

languagestring

ISO-639-1-Sprachcode für Suchergebnisse (z. B. en, de, fr).

search_langstring

Brave-Sprachcode für die Suche (z. B. en, en-gb, zh-hans).

ui_langstring

ISO-Sprachcode für Elemente der Benutzeroberfläche.

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

Zeitfilter – day entspricht 24 Stunden.

date_afterstring

Nur Ergebnisse, die nach diesem Datum (YYYY-MM-DD) veröffentlicht wurden.

date_beforestring

Nur Ergebnisse, die vor diesem Datum (YYYY-MM-DD) veröffentlicht wurden.

Beispiele:

javascript
// Länder- und sprachspezifische Sucheawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Aktuelle Ergebnisse (vergangene Woche)await web_search({  query: "AI news",  freshness: "week",}); // Suche in einem Datumsbereichawait 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 älteres Abonnement haben (z. B. den ursprünglichen kostenlosen Tarif mit 2.000 Anfragen pro Monat), bleibt es gültig, enthält jedoch keine neueren Funktionen wie LLM Context oder höhere Ratenlimits.
  • Jeder Brave-Tarif umfasst $5 kostenloses Guthaben pro Monat (wird monatlich erneuert). Der Search-Tarif kostet $5 pro 1.000 Anfragen, sodass das Guthaben 1.000 Anfragen pro Monat abdeckt. 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 Rechte zur KI-Inferenz. Für das Speichern von Ergebnissen zum Trainieren oder Abstimmen von Modellen ist ein Tarif mit ausdrücklichen Speicherrechten erforderlich. Siehe die Nutzungsbedingungen von Brave.
  • Der Modus llm-context gibt fundierte Quelleinträge anstelle der normalen Auszüge der Websuche zurück.
  • Der Modus llm-context unterstützt freshness und begrenzte Bereiche mit date_after und date_before. Er unterstützt ui_lang nicht; date_before ohne date_after wird abgelehnt, da Brave bei benutzerdefinierten Aktualitätsbereichen sowohl ein Start- als auch ein Enddatum voraussetzt.
  • ui_lang muss ein Regions-Subtag wie en-US enthalten.
  • Ergebnisse werden standardmäßig 15 Minuten lang zwischengespeichert (über cacheTtlMinutes konfigurierbar).
  • Benutzerdefinierte Werte für webSearch.baseUrl werden in die Brave-Cache-Identität einbezogen, sodass Proxy-spezifische Antworten nicht miteinander kollidieren.
  • Aktivieren Sie zur Fehlerbehebung das Diagnose-Flag brave.http, um Brave-Anfrage-URLs und Abfrageparameter, Antwortstatus und -dauer sowie Treffer-, Fehltreffer- und Schreibereignisse des Such-Caches zu protokollieren. Das Flag protokolliert weder den API-Schlüssel noch Antwortinhalte, Suchanfragen können jedoch vertraulich sein.

Verwandte Themen

Was this useful?
On this page

On this page