OpenClaw Such-Provider Auswahlleitfaden (Brave/Gemini/Grok/Tavily/SerpAPI etc.)

Schwierigkeitsgrad: Mittel | Dauer: 20 Minuten | Lernziel: Beherrschen der Auswahl des am besten geeigneten Such-Providers für OpenClaw basierend auf realen Szenarien.

Zielgruppe

• Entwickler, die das OpenClaw-Basis-Setup abgeschlossen haben und nun ernsthaft Suchfunktionen integrieren möchten.
• Ingenieure, die angesichts von 10 Providern nicht wissen, welchen sie wählen sollen.
• Nutzer, die das Suchverhalten für spezifische Szenarien (RAG / Online-Reputationsmanagement / E-Commerce-Tracking etc.) tiefgreifend anpassen möchten.

Kernabhängigkeiten

• OpenClaw (neueste Version)
• Node.js 18+
• API-Key für mindestens einen Such-Provider

Projektstruktur

openclaw/
├── config.yaml     # Alle Provider-Konfigurationen befinden sich hier
└── .env            # API-Keys hier speichern, nicht ins Repository hochladen

1. Übersicht der OpenClaw Suchfunktionen

Im Agentic Loop von OpenClaw spielt das Such-Tool die Rolle der „Echtzeit-Wahrnehmungsschicht“ – wenn der Agent feststellt, dass seine Trainingsdaten nicht ausreichen, ruft er aktiv das Such-Tool auf, um Informationen zu ergänzen, bevor er über den nächsten Schritt entscheidet.

Benutzerfrage
   ↓
Agent denkt nach: Benötige ich aktuelle Informationen?
   ↓ Ja
Such-Provider aufrufen → Ergebnisse erhalten
   ↓
Informationen konsolidieren → Antwort generieren

[!TIP]
Ohne Such-Provider kann sich OpenClaw nur auf die Trainingsdaten des Modells verlassen. Bei Fragen wie „Was ist die neueste Version?“ oder „Heutige Nachrichten“ könnte der Agent halluzinieren. Die Konfiguration der Suche ist der erste Schritt, um den Agenten wirklich „lebendig“ zu machen.

Derzeit unterstützt OpenClaw 10 Such-Provider, unterteilt in zwei Kategorien:

Typ	Provider	Merkmale	Kostenloses Kontingent	Einstiegspreis
Offiziell	Perplexity	Strukturierte Ergebnisse, Zeit-/Domainfilter	Keine	$1/M Tokens
Offiziell	Brave Search	Privatsphäre zuerst, regionale Suche	~1.000 Anfragen/Monat	$5/1k
Offiziell	Gemini	Google-Ökosystem, automatisches Grounding	Großzügiges Kontingent	Abrechnung nach Prompt
Offiziell	Grok	Web + X (Twitter) Suche	Keine	$10/1k Tool-Calls
Offiziell	Kimi	256K extrem langer Kontext	Keine	$0.60/M Tokens
Drittanbieter	Tavily	Optimiert für LLMs, strukturschonend	1.000 Anfragen/Monat	Pay-as-you-go
Drittanbieter	Serper.dev	Schnellste & günstigste Google SERP	2.500 Aufrufe bei Reg.	$0.30/1k
Drittanbieter	SerpAPI	Multi-Engine, unterstützt Screenshots	250 Anfragen/Monat	$7.50/1k
Drittanbieter	Exa	Semantische neuronale Netzsuche	Kostenlose Testversion	Pay-as-you-go
Drittanbieter	DataForSEO	Enterprise-Level, 10+ Engines	$1 Startguthaben	$0.60/1k

2. Kernkriterien für die Auswahl

Bevor Sie einen Provider wählen, gleichen Sie diese 4 Dimensionen ab:

Dimension	Schlüsselfrage	Einfluss auf Entscheidung
Aktualität	Wie frisch müssen Ergebnisse sein? Echtzeit / Woche / Monat?	News-Szenarien erfordern Echtzeit-Indizierung
Qualität	Erforderlich: Originallinks oder vorverarbeitete Snippets?	KI-Agenten bevorzugen Snippet-basierte Provider
Kosten	Wie hoch ist das geschätzte monatliche Volumen?	Hohe Frequenz bietet großes Sparpotenzial
Funktionen	Domain-Whitelists / Geolocation / spezifische Engines nötig?	Funktionsunterschiede sind in Nischen entscheidend

3. Auswahlhilfe für 10 Top-Szenarien

Szenario 1: Code-QA Agent

Anforderung: Nutzer fragen „Wie fix ich diesen Error?“ oder „Was ist die neueste API dieser Lib?“. Antworten finden sich meist auf GitHub, Stack Overflow oder offiziellen Docs.

Empfehlung: Perplexity + searchDomainFilter

Grund: Das sonar-Modell von Perplexity versteht technische Inhalte am besten. Mit einer Domain-Whitelist erzwingen Sie Ergebnisse von autoritativen Seiten und vermeiden minderwertige Blogs.

tools:
  web:
    search:
      enabled: true
      provider: perplexity
      maxResults: 5
      perplexity:
        apiKey:
          source: env
          provider: default
          id: PERPLEXITY_API_KEY
        model: sonar                # Leichtgewichtig und schnell
        searchRecencyFilter: month  # Inhalte des letzten Monats
        searchDomainFilter:
          - "github.com"
          - "stackoverflow.com"
          - "docs.python.org"
          - "developer.mozilla.org"
          - "pkg.go.dev"

---

Szenario 2: News-Summary Bot

Anforderung: Tägliche Zusammenfassung aktueller Nachrichten aus Bereichen wie KI, Tech oder Finanzen. Aktualität hat oberste Priorität.

Empfehlung: Serper.dev mit type: news

Serper hat einen dedizierten News-Endpunkt, der Google News Echtzeit-Ergebnisse liefert. Die Antwortzeit liegt bei 1–2 Sek., die Preise gehören zu den niedrigsten am Markt.

tools:
  web:
    search:
      enabled: true
      provider: serper
      maxResults: 10
      cacheTtlMinutes: 30       # Cache für 30 Minuten
      serper:
        apiKey:
          source: env
          provider: default
          id: SERPER_API_KEY
        type: news              # News-Endpunkt nutzen
        num: 10                 

---

Szenario 3: Wissenschaftlicher Forschungs-Agent

Anforderung: Suche nach Papers, Analyse von Trends. Benötigt semantisches Verständnis, kein bloßes Keyword-Matching.

Empfehlung: Exa (Semantische Suche + Domainfilter)

Exa basiert auf Embedding-Vektoren und versteht Anfragen wie „Anwendungen von Quantencomputing in der Kryptografie“.

tools:
  web:
    search:
      enabled: true
      provider: exa
      maxResults: 8
      exa:
        apiKey:
          source: env
          provider: default
          id: EXA_API_KEY
        endpoint: auto          
        includeDomains:
          - "arxiv.org"
          - "semanticscholar.org"
          - "pubmed.ncbi.nlm.nih.gov"
        startPublishedDate: "2024-01-01"   

---

Szenario 4: X/Twitter Monitoring

Anforderung: Verfolgung von Echtzeit-Diskussionen über Marken oder Produkte auf X. Normale Suchmaschinen erfassen X-Inhalte oft nicht zeitnah.

Empfehlung: Grok mit aktiviertem x_search

Dies ist eine exklusive Fähigkeit von Grok – direkter Zugriff auf X-Plattform-Inhalte.

tools:
  web:
    search:
      enabled: true
      provider: grok
      grok:
        apiKey:
          source: env
          provider: default
          id: XAI_API_KEY
        model: grok-4-1-fast    
        inlineCitations: true
        tools:
          - type: x_search
            fromDate: "2025-01-01"      
            allowedXHandles:            
              - "sama"
              - "karpathy"
          - type: web_search            
            enableImageUnderstanding: true

---

Szenario 5: E-Commerce Preis-Tracking

Anforderung: Preisänderungen bei Google Shopping überwachen oder günstigste Angebote für Nutzer finden.

Empfehlung: SerpAPI mit engine: google_shopping

SerpAPI ist derzeit der einzige Provider mit ausgereifter strukturierter Google Shopping Datenausgabe (Preise, Händler, Bewertungen).

tools:
  web:
    search:
      enabled: true
      provider: serpapi
      maxResults: 20
      cacheTtlMinutes: 60       
      serpapi:
        apiKey:
          source: env
          provider: default
          id: SERPAPI_API_KEY
        engine: google_shopping  
        gl: us                   # Marktregion
        hl: en
        location: "New York, New York, United States"

---

Szenario 6: SEO Content Generierung

Anforderung: Batch-Analyse der SERP-Struktur für Keywords zur Erstellung von Content-Strategien.

Empfehlung: DataForSEO mit mode: normal

Der normal-Modus von DataForSEO arbeitet mit einer Warteschlange (ca. 5 Min. Rücklaufzeit) und kostet nur $0,0006 pro Aufruf – 3x günstiger als der Live-Modus. Da SEO-Analysen meist nicht zeitkritisch sind, spart dies massiv Kosten.

tools:
  web:
    search:
      enabled: true
      provider: dataforseo
      maxResults: 10
      cacheTtlMinutes: 1440     # 24h Cache für SEO-Daten
      dataforseo:
        login:
          source: env
          provider: default
          id: DATAFORSEO_LOGIN
        password:
          source: env
          provider: default
          id: DATAFORSEO_PASSWORD
        engine: google
        mode: normal            # Warteschlangen-Modus
        locationCode: 2276      # 2276 = Deutschland
        languageCode: de

---

Szenario 7: Interne Unternehmenswissenssuche

Anforderung: Suche priorisiert auf interne Wikis oder technische Dokumentation beschränken, externe Seiten ignorieren oder abwerten.

Empfehlung: Brave Search + Goggles

Mit Goggles von Brave können Sie Ranking-Regeln definieren, um z.B. interne Dokumentationsseiten massiv zu stärken.

tools:
  web:
    search:
      enabled: true
      provider: brave
      maxResults: 8
      brave:
        apiKey:
          source: env
          provider: default
          id: BRAVE_API_KEY
        goggles_id: "https://raw.githubusercontent.com/your-org/goggles/main/internal-docs.goggle"
        freshness: pm           

---

Szenario 8: Multilingual Marktforschung

Anforderung: Globale Marktanalyse durch Simulation von Suchen in verschiedenen Ländern/Sprachen.

Empfehlung: SerpAPI mit flexibler location + hl + gl Konfiguration.

SerpAPI ermöglicht eine präzise Simulation ("Spoofing") des Standorts bis auf Stadtebene.

tools:
  web:
    search:
      enabled: true
      provider: serpapi
      serpapi:
        apiKey:
          source: env
          provider: default
          id: SERPAPI_API_KEY
        engine: google
        location: "Berlin, Berlin, Germany"
        hl: de          
        gl: de          

---

Szenario 9: Hochfrequente Batch-Aufgaben (Low-Cost)

Anforderung: Der Agent führt sehr häufig Suchen aus (z.B. minütliches Monitoring). Kosten sind der kritische Faktor.

Empfehlung: Serper.dev + aggressive Caching-Strategie

Serper kostet bei großen Paketen nur $0,30/1k. In Kombination mit Caching sinken die Kosten auf ein Branchenminimum.

tools:
  web:
    search:
      enabled: true
      provider: serper
      cacheTtlMinutes: 120      # 2h Cache reduziert doppelte Kosten
      serper:
        apiKey:
          source: env
          provider: default
          id: SERPER_API_KEY
        type: search
        num: 5

---

Szenario 10: Null Euro Budget ($0)

Anforderung: Persönliche Projekte oder frühe Validierung ohne laufende Kosten.

Strategie: Rotation der kostenlosen Kontingente

Provider	Gratis-Kontingent	Gesamt
Brave Search	~1.000/Monat
Tavily	1.000/Monat
SerpAPI	250/Monat
Summe		~2.250/Monat

Konfigurieren Sie alle API-Keys und wechseln Sie den provider in OpenClaw manuell oder automatisiert, wenn ein Kontingent erschöpft ist.

4. Quick-Check: Szenario → Provider

Szenario	Empfohlener Provider	Key-Parameter	Geschätzte Kosten (1k)
Code-QA	Perplexity	searchDomainFilter	~$1
News-Summary	Serper.dev	type: news	$0.30–$1
Forschung	Exa	includeDomains	Pay-as-you-go
X Monitoring	Grok	x_search	$10/1k Calls
Preis-Tracking	SerpAPI	engine: google_shopping	$7.50
SEO Content	DataForSEO	mode: normal	$0.60
Interne Docs	Brave + Goggles	goggles_id	$5/1k
Low-Cost Batch	Serper.dev	cacheTtlMinutes: 120	$0.30
$0 Budget	Tavily / Brave	searchDepth: basic	$0

5. Profi-Tipp: Fallback-Strategie

Für Produktionsumgebungen empfiehlt sich eine Fallback-Strategie: Wenn der Haupt-Provider ausfällt oder das Limit erreicht ist, übernimmt automatisch ein Ersatz-Provider.

tools:
  web:
    search:
      enabled: true
      provider: perplexity      # Haupt-Provider
      timeoutSeconds: 20        
      perplexity:
        apiKey: { source: env, id: PERPLEXITY_API_KEY }
        model: sonar

      fallback:
        provider: serper
        serper:
          apiKey: { source: env, id: SERPER_API_KEY }
          type: search

6. Häufige Fehlerbehebung (FAQ)

Q: Der Agent nutzt das Such-Tool nicht.
A: Stellen Sie sicher, dass Ihr System-Prompt den Agenten explizit anweist, bei fehlenden Informationen das Such-Tool zu verwenden.

Q: searchDomainFilter bei Perplexity funktioniert nicht.
A: Geben Sie Domains ohne https:// an (z.B. github.com statt https://github.com).

Q: DataForSEO liefert keine Resultate.
A: Im normal-Modus müssen Sie etwa 5 Minuten warten. Wenn Sie Echtzeit-Feedback benötigen, wechseln Sie zu mode: live.

---

Weiterführende Links:

• Offizielle OpenClaw Docs
• Perplexity Sonar Dokumentation
• Tavily API Referenz