Brave Search API

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

API-Key besorgen

Erstelle ein Brave Search API-Konto unter https://brave.com/search/api/
Wähle im Dashboard den Search-Plan und generiere einen API-Key.
Speichere den Key in der Konfiguration oder setze BRAVE_API_KEY in der Gateway-Umgebung.

Konfigurationsbeispiel

{
  tools: {
    web: {
      search: {
        provider: "brave",
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

Tool-Parameter

Parameter	Beschreibung
`query`	Suchanfrage (Pflichtfeld)
`count`	Anzahl der Ergebnisse (1-10, Standard: 5)
`country`	2-stelliger ISO-Ländercode (z. B. “US”, “DE”)
`language`	ISO 639-1-Sprachcode für Suchergebnisse (z. B. “en”, “de”, “fr”)
`ui_lang`	ISO-Sprachcode für UI-Elemente
`freshness`	Zeitfilter: `day` (24h), `week`, `month` oder `year`
`date_after`	Nur Ergebnisse nach diesem Datum (YYYY-MM-DD)
`date_before`	Nur Ergebnisse vor diesem Datum (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 mit Datumsbereich
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

Hinweise

OpenClaw nutzt den Brave Search-Plan. Falls du ein Legacy-Abo hast (z. B. den ursprünglichen Free-Plan mit 2.000 Anfragen/Monat), bleibt es gültig, enthält aber keine neueren Features wie LLM Context oder höhere Rate-Limits.
Jeder Brave-Plan enthält 5 $/Monat als kostenloses Guthaben (wird monatlich erneuert). Der Search-Plan kostet 5 $ pro 1.000 Anfragen, das Guthaben deckt also 1.000 Abfragen/Monat ab. Setze dein Nutzungslimit im Brave-Dashboard, um unerwartete Kosten zu vermeiden. Aktuelle Pläne findest du im Brave API-Portal.
Der Search-Plan enthält den LLM-Context-Endpunkt und AI-Inference-Rechte. Um Ergebnisse zum Trainieren oder Feintunen von Modellen zu speichern, benötigst du einen Plan mit expliziten Speicherrechten. Siehe die Brave Nutzungsbedingungen.
Ergebnisse werden standardmäßig 15 Minuten gecacht (konfigurierbar über cacheTtlMinutes).

Siehe Web-Tools für die vollständige web_search-Konfiguration.