Brave-Suche

​

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 Search-Tarif 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

{
  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,
      },
    },
  },
}

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

​

Tool-Parameter

// Länder- und sprachspezifische Suche
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Aktuelle Ergebnisse (vergangene 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 älteres Abonnement haben (z. B. den ursprünglichen Free-Tarif mit 2.000 Anfragen/Monat), bleibt es gültig, enthält jedoch keine neueren Funktionen wie LLM Context oder höhere Ratenlimits.
• Jeder Brave-Tarif umfasst ein monatlich erneuertes Gratisguthaben von 5 $. Der Search-Tarif kostet 5 $ pro 1.000 Anfragen, sodass das Guthaben 1.000 Anfragen/Monat abdeckt. Legen Sie im Brave-Dashboard Ihr Nutzungslimit 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. 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 fundierte Quelleinträge anstelle der normalen Textausschnittstruktur der Websuche zurück.
• Der Modus llm-context unterstützt freshness und begrenzte Bereiche mit date_after + 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 verlangt.
• ui_lang muss ein Regions-Subtag wie en-US enthalten.
• Ergebnisse werden standardmäßig 15 Minuten lang zwischengespeichert (konfigurierbar über cacheTtlMinutes).
• Benutzerdefinierte webSearch.baseUrl-Werte werden in die Brave-Cache-Identität aufgenommen, sodass proxyspezifische Antworten nicht kollidieren.
• Aktivieren Sie das Diagnose-Flag brave.http, um bei der Fehlerbehebung Brave-Anfrage-URLs/-Abfrageparameter, Antwortstatus/-dauer sowie Treffer-, Fehlschlag- und Schreibereignisse des Such-Caches zu protokollieren. Das Flag protokolliert niemals den API-Schlüssel oder Antwortinhalte, Suchanfragen können jedoch vertraulich sein.

​

Verwandte Themen

• Übersicht zur Websuche — alle Provider und automatische Erkennung
• Perplexity Search — strukturierte Ergebnisse mit Domainfilterung
• Exa Search — neuronale Suche mit Inhaltsextraktion