Web-Tools

OpenClaw bringt zwei schlanke Web-Tools mit:

web_search — Web über Brave Search API (Standard) oder Perplexity Sonar durchsuchen (direkt oder über OpenRouter).
web_fetch — HTTP-Fetch + lesbare Extraktion (HTML → Markdown/Text).

Das ist keine Browser-Automatisierung. Für JS-lastige Seiten oder Logins das Browser-Tool nutzen.

So funktioniert es

web_search ruft deinen konfigurierten Provider auf und liefert Ergebnisse.
- Brave (Standard): strukturierte Ergebnisse (Titel, URL, Snippet).
- Perplexity: KI-synthetisierte Antworten mit Zitaten aus Echtzeit-Websuche.
Ergebnisse werden pro Abfrage 15 Minuten gecacht (konfigurierbar).
web_fetch führt einen einfachen HTTP-GET aus und extrahiert lesbaren Inhalt (HTML → Markdown/Text). Führt kein JavaScript aus.
web_fetch ist standardmäßig aktiviert (außer explizit deaktiviert).

Such-Provider wählen

Provider	Vorteile	Nachteile	API-Key
Brave (Standard)	Schnell, strukturierte Ergebnisse, Free-Tier	Klassische Suchergebnisse	`BRAVE_API_KEY`
Perplexity	KI-Antworten, Zitate, Echtzeit	Erfordert Perplexity- oder OpenRouter-Zugang	`OPENROUTER_API_KEY` oder `PERPLEXITY_API_KEY`

Siehe Brave Search Setup und Perplexity Sonar für Provider-Details. Provider in der Config setzen:


{
  tools: {
    web: {
      search: {
        provider: "brave"  // oder "perplexity"
      }
    }
  }
}

Beispiel: Wechsel zu Perplexity Sonar (direkte API):


{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro"
        }
      }
    }
  }
}

Brave-API-Key besorgen

Brave Search API-Account unter https://brave.com/search/api/ anlegen.
Im Dashboard den Plan Data for Search (nicht „Data for AI“) wählen und API-Key erzeugen.
openclaw configure --section web ausführen, um den Key in der Config zu speichern (empfohlen), oder BRAVE_API_KEY in der Umgebung setzen.

Brave bietet ein Free-Tier plus kostenpflichtige Pläne; aktuelle Limits und Preise im Brave-API-Portal prüfen.

Wo den Key setzen (empfohlen)

Empfohlen: openclaw configure --section web ausführen. Der Key wird in ~/.clawdbot/openclaw.json unter tools.web.search.apiKey gespeichert. Alternative Umgebung: BRAVE_API_KEY in der Gateway-Prozessumgebung setzen. Bei Gateway-Installation in ~/.clawdbot/.env (oder deiner Service-Umgebung) eintragen. Siehe Env-Vars.

Perplexity nutzen (direkt oder über OpenRouter)

Perplexity-Sonar-Modelle haben eingebaute Web-Suchfähigkeit und liefern KI-Antworten mit Zitaten. Nutzbar über OpenRouter (ohne Kreditkarte – Krypto/Prepaid unterstützt).

OpenRouter-API-Key besorgen

Account unter https://openrouter.ai/ anlegen.
Credits hinzufügen (Krypto, Prepaid oder Kreditkarte).
API-Key in den Account-Einstellungen erzeugen.

Perplexity-Suche einrichten


{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "perplexity",
        perplexity: {
          // API-Key (optional wenn OPENROUTER_API_KEY oder PERPLEXITY_API_KEY gesetzt)
          apiKey: "sk-or-v1-...",
          // Base-URL (Key-abhängiger Default wenn weggelassen)
          baseUrl: "https://openrouter.ai/api/v1",
          // Modell (Standard: perplexity/sonar-pro)
          model: "perplexity/sonar-pro"
        }
      }
    }
  }
}

Alternative Umgebung: OPENROUTER_API_KEY oder PERPLEXITY_API_KEY in der Gateway-Umgebung setzen. Bei Gateway-Installation in ~/.clawdbot/.env eintragen. Ohne gesetzte Base-URL wählt OpenClaw einen Default nach API-Key-Quelle:

PERPLEXITY_API_KEY oder pplx-... → https://api.perplexity.ai
OPENROUTER_API_KEY oder sk-or-... → https://openrouter.ai/api/v1
Unbekannte Key-Formate → OpenRouter (sicherer Fallback)

Verfügbare Perplexity-Modelle

Modell	Beschreibung	Am besten für
`perplexity/sonar`	Schnelle Q&A mit Web-Suche	Schnelle Lookups
`perplexity/sonar-pro` (Standard)	Mehrschrittiges Reasoning mit Web-Suche	Komplexe Fragen
`perplexity/sonar-reasoning-pro`	Chain-of-Thought-Analyse	Tiefere Recherche

web_search

Web mit dem konfigurierten Provider durchsuchen.

Anforderungen

tools.web.search.enabled darf nicht false sein (Standard: aktiviert)
API-Key für den gewählten Provider:
- Brave: BRAVE_API_KEY oder tools.web.search.apiKey
- Perplexity: OPENROUTER_API_KEY, PERPLEXITY_API_KEY oder tools.web.search.perplexity.apiKey

Config


{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE", // optional wenn BRAVE_API_KEY gesetzt
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15
      }
    }
  }
}

Tool-Parameter

query (erforderlich)
count (1–10; Default aus Config)
country (optional): 2-Buchstaben-Ländercode für regionale Ergebnisse (z. B. „DE“, „US“, „ALL“). Wenn weggelassen, nutzt Brave seine Standard-Region.
search_lang (optional): ISO-Sprachcode für Suchergebnisse (z. B. „de“, „en“, „fr“)
ui_lang (optional): ISO-Sprachcode für UI-Elemente
freshness (optional, nur Brave): Filter nach Entdeckungszeit (pd, pw, pm, py oder YYYY-MM-DDtoYYYY-MM-DD)

Beispiele:


// Deutschsprachige Suche
await web_search({
  query: "TV online schauen",
  count: 10,
  country: "DE",
  search_lang: "de"
});

// Französische Suche mit französischer UI
await web_search({
  query: "actualités",
  country: "FR",
  search_lang: "fr",
  ui_lang: "fr"
});

// Kürzliche Ergebnisse (letzte Woche)
await web_search({
  query: "TMBG interview",
  freshness: "pw"
});

web_fetch

URL abrufen und lesbaren Inhalt extrahieren.

Anforderungen

tools.web.fetch.enabled darf nicht false sein (Standard: aktiviert)
Optionaler Firecrawl-Fallback: tools.web.fetch.firecrawl.apiKey oder FIRECRAWL_API_KEY setzen.

Config


{
  tools: {
    web: {
      fetch: {
        enabled: true,
        maxChars: 50000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        maxRedirects: 3,
        userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
        readability: true,
        firecrawl: {
          enabled: true,
          apiKey: "FIRECRAWL_API_KEY_HERE", // optional wenn FIRECRAWL_API_KEY gesetzt
          baseUrl: "https://api.firecrawl.dev",
          onlyMainContent: true,
          maxAgeMs: 86400000, // ms (1 Tag)
          timeoutSeconds: 60
        }
      }
    }
  }
}

Tool-Parameter

url (erforderlich, nur http/https)
extractMode (markdown | text)
maxChars (lange Seiten kürzen)

Hinweise:

web_fetch nutzt zuerst Readability (Main-Content-Extraktion), dann Firecrawl (wenn konfiguriert). Schlagen beide fehl, gibt das Tool einen Fehler zurück.
Firecrawl-Anfragen nutzen Bot-Umgehungsmodus und cachen standardmäßig.
web_fetch sendet standardmäßig einen Chrome-ähnlichen User-Agent und Accept-Language; bei Bedarf userAgent überschreiben.
web_fetch blockiert private/interne Hostnamen und prüft Redirects erneut (mit maxRedirects begrenzen).
web_fetch ist Best-Effort-Extraktion; manche Seiten brauchen das Browser-Tool.
Siehe Firecrawl für Key-Setup und Service-Details.
Antworten werden gecacht (Standard 15 Minuten), um wiederholte Fetches zu reduzieren.
Bei Tool-Profilen/Allowlists web_search/web_fetch oder group:web hinzufügen.
Fehlt der Brave-Key, gibt web_search einen kurzen Setup-Hinweis mit Docs-Link zurück.