Web-Tools in OpenClaw: Suchen und Extrahieren ohne Overhead

Wenn du versuchst, Echtzeit-Daten in deine App zu bringen, stehst du oft vor einer Wand. Entweder sind die APIs zu komplex oder die Daten, die du von einer Website zurückbekommst, sind völlig unstrukturiert. Du verbringst Stunden damit, HTML-Parser zu schreiben, nur um festzustellen, dass sich die Struktur der Seite schon wieder geändert hat.

Manchmal brauchst du einfach nur eine schnelle Antwort aus dem Web oder den Textinhalt einer URL, ohne direkt eine schwere Browser-Automatisierung zu starten. Genau hier setzen die Web-Tools von OpenClaw an. Sie sind leichtgewichtig und liefern dir sauber aufbereitete Daten.

Voraussetzungen

• API Key für einen Provider (z. B. Brave oder Perplexity)
• Laufende OpenClaw Instanz

Schnellstart

In weniger als fünf Minuten hast du die Websuche integriert. So gehst du vor:

1. Wähle deinen Provider. Ich empfehle Perplexity Search API, wenn du strukturierte Ergebnisse und Content Extraction benötigst.
2. Führe openclaw configure --section web aus, um deinen API Key zu hinterlegen.
3. Starte deine Suche mit dem web_search Tool direkt in deinem Workflow.
4. Nutze web_fetch, um Inhalte von URLs direkt als Markdown zu lesen.

So funktionieren die Web-Tools

OpenClaw bietet dir zwei spezialisierte Tools: web_search für die Suche und web_fetch für das Abrufen von Inhalten. Wichtig: Das ist keine Browser-Automatisierung. Wenn du JavaScript-lastige Seiten oder Logins brauchst, solltest du das Browser tool verwenden.

• web_search: Ruft deinen konfigurierten Provider auf. Ergebnisse werden standardmäßig für 15 Minuten zwischengespeichert.
• web_fetch: Macht einen einfachen HTTP GET und extrahiert den lesbaren Inhalt (HTML → Markdown/Text). JavaScript wird nicht ausgeführt.

Den passenden Search Provider wählen

Provider	Vorteile	Nachteile	API Key
Perplexity Search API	Schnell, strukturierte Ergebnisse; Filter für Domain, Sprache, Region; Content Extraction	—	PERPLEXITY_API_KEY
Brave Search API	Schnell, strukturierte Ergebnisse	Weniger Filter; AI-Nutzungsbedingungen	BRAVE_API_KEY
Gemini	Google Search grounding, KI-synthetisiert	Erfordert Gemini API Key	GEMINI_API_KEY
Grok	xAI Web-grounded Antworten	Erfordert xAI API Key	XAI_API_KEY
Kimi	Moonshot Web-Suche Kapazität	Erfordert Moonshot API Key	KIMI_API_KEY / MOONSHOT_API_KEY

Auto-Detection

Wenn du keinen Provider explizit setzt, prüft OpenClaw die verfügbaren API Keys in dieser Reihenfolge: Brave, Gemini, Kimi, Perplexity, Grok. Findet das System keinen Key, wird standardmäßig Brave gewählt (was zu einem Fehler führt, der dich zur Konfiguration auffordert).

Web-Suche einrichten

Verwende openclaw configure --section web, um deinen Key zu speichern. Du kannst den Key entweder in der Config oder als Umgebungsvariable (Environment Variable) hinterlegen.

Konfigurations-Beispiele

Perplexity Search:

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...", // optional falls PERPLEXITY_API_KEY gesetzt ist
        },
      },
    },
  },
}

Brave Search:

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "brave",
        apiKey: "YOUR_BRAVE_API_KEY", // optional falls BRAVE_API_KEY gesetzt ist
      },
    },
  },
}

Nutzung von Gemini (Google Search grounding)

Gemini Modelle unterstützen integriertes Google Search grounding. Das liefert dir KI-generierte Antworten basierend auf Live-Ergebnissen inklusive Quellenangaben.

{
  tools: {
    web: {
      search: {
        provider: "gemini",
        gemini: {
          apiKey: "AIza...",
          model: "gemini-2.5-flash",
        },
      },
    },
  },
}

web_search Parameter

Du kannst die Suche präzise steuern. Hier sind die wichtigsten Parameter:

Parameter	Beschreibung
query	Suchanfrage (erforderlich)
count	Anzahl der Ergebnisse (1-10, Default: 5)
country	ISO-Ländercode (z. B. “DE”)
language	ISO-Sprachcode (z. B. “de”)
freshness	Zeitfilter: day, week, month, oder year
domain_filter	Erlaubte/Blockierte Domains (nur Perplexity)

Beispiel für eine spezifische Suche:

// Suche begrenzt auf Deutschland und deutsche Sprache
await web_search({
  query: "TV online schauen",
  country: "DE",
  language: "de",
});

// Domain-Filter nutzen (nur Perplexity)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

Inhalte extrahieren mit web_fetch

web_fetch holt dir den Text einer Seite ohne den ganzen HTML-Ballast. Es nutzt primär Readability zur Extraktion und kann bei Bedarf auf Firecrawl zurückgreifen.

Konfigurations-Beispiel:

{
  tools: {
    web: {
      fetch: {
        enabled: true,
        maxChars: 50000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        firecrawl: {
          enabled: true,
          apiKey: "FIRECRAWL_API_KEY_HERE",
        },
      },
    },
  },
}

Fehlerbehebung

• Fehlender API Key: Wenn kein Key gefunden wird, gibt web_search einen kurzen Hinweis und einen Link zur Dokumentation aus.
• JavaScript-Probleme: web_fetch führt kein JS aus. Wenn eine Seite leer bleibt oder eine Fehlermeldung anzeigt, wechsle zum Browser tool.
• Zu große Seiten: Antworten werden bei Überschreiten von maxResponseBytes abgeschnitten. Du erhältst in diesem Fall eine Warnung im Output.
• Sicherheit: web_fetch blockiert Anfragen an private oder interne Hostnames und prüft Redirects streng nach SSRF-Standards.

Du hast Fragen zur Einrichtung? Nutze den AI Setup Assistant.

Nächste Schritte

• Browser tool – Für komplexe Webseiten mit JavaScript.
• Firecrawl – Details zum erweiterten Fetching-Service.
• Perplexity Search setup – Spezifische Provider-Details.
• Brave Search setup – Alles zur Brave-Integration.