Zum Hauptinhalt springen

​
Tavily

OpenClaw kann Tavily auf zwei Arten verwenden:
  • als web_search-Provider
  • als explizite Plugin-Tools: tavily_search und tavily_extract
Tavily ist eine Such-API, die für KI-Anwendungen entwickelt wurde und strukturierte Ergebnisse zurückgibt, die für die Nutzung mit LLMs optimiert sind. Sie unterstützt konfigurierbare Suchtiefe, Themen- Filterung, Domain-Filter, KI-generierte Antwortzusammenfassungen und Inhaltsextraktion aus URLs (einschließlich mit JavaScript gerenderter Seiten).

​
API-Schlüssel erhalten

  1. Erstellen Sie ein Tavily-Konto unter tavily.com.
  2. Generieren Sie im Dashboard einen API-Schlüssel.
  3. Speichern Sie ihn in der Konfiguration oder setzen Sie TAVILY_API_KEY in der Gateway-Umgebung.

​
Tavily-Suche konfigurieren

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
Hinweise:
  • Wenn Sie Tavily im Onboarding oder über openclaw configure --section web auswählen, wird das gebündelte Tavily-Plugin automatisch aktiviert.
  • Speichern Sie die Tavily-Konfiguration unter plugins.entries.tavily.config.webSearch.*.
  • web_search mit Tavily unterstützt query und count (bis zu 20 Ergebnisse).
  • Für Tavily-spezifische Steuerungen wie search_depth, topic, include_answer oder Domain-Filter verwenden Sie tavily_search.

​
Tavily-Plugin-Tools

Verwenden Sie dies, wenn Sie Tavily-spezifische Suchsteuerungen statt des generischen web_search möchten.
ParameterBeschreibung
querySuchanfrage als Zeichenkette (unter 400 Zeichen halten)
search_depthbasic (Standard, ausgewogen) oder advanced (höchste Relevanz, langsamer)
topicgeneral (Standard), news (Echtzeit-Updates) oder finance
max_resultsAnzahl der Ergebnisse, 1-20 (Standard: 5)
include_answerKI-generierte Antwortzusammenfassung einschließen (Standard: false)
time_rangeNach Aktualität filtern: day, week, month oder year
include_domainsArray von Domains, auf die Ergebnisse beschränkt werden sollen
exclude_domainsArray von Domains, die aus den Ergebnissen ausgeschlossen werden sollen
Suchtiefe:
TiefeGeschwindigkeitRelevanzAm besten geeignet für
basicSchnellerHochAllgemeine Suchanfragen (Standard)
advancedLangsamerHöchstePräzision, spezifische Fakten, Recherche

​
tavily_extract

Verwenden Sie dies, um bereinigte Inhalte aus einer oder mehreren URLs zu extrahieren. Behandelt mit JavaScript gerenderte Seiten und unterstützt query-fokussiertes Chunking für gezielte Extraktion.
ParameterBeschreibung
urlsArray von zu extrahierenden URLs (1-20 pro Anfrage)
queryExtrahierte Chunks nach Relevanz für diese Query neu ranken
extract_depthbasic (Standard, schnell) oder advanced (für JS-lastige Seiten)
chunks_per_sourceChunks pro URL, 1-5 (erfordert query)
include_imagesBild-URLs in die Ergebnisse einschließen (Standard: false)
Extraktionstiefe:
TiefeWann verwenden
basicEinfache Seiten - probieren Sie dies zuerst
advancedMit JS gerenderte SPAs, dynamische Inhalte, Tabellen
Tipps:
  • Maximal 20 URLs pro Anfrage. Teilen Sie größere Listen auf mehrere Aufrufe auf.
  • Verwenden Sie query + chunks_per_source, um nur relevante Inhalte statt ganzer Seiten zu erhalten.
  • Probieren Sie zuerst basic; verwenden Sie advanced, wenn Inhalte fehlen oder unvollständig sind.

​
Das richtige Tool auswählen

BedarfTool
Schnelle Websuche ohne besondere Optionenweb_search
Suche mit Tiefe, Thema, KI-Antwortentavily_search
Inhalte aus bestimmten URLs extrahierentavily_extract

​
Verwandt