Tavily

Tavily ist eine für KI-Anwendungen entwickelte Such-API. OpenClaw stellt sie auf zwei Arten bereit:

als web_search-Provider für das generische Suchwerkzeug
als explizite Plugin-Werkzeuge: tavily_search und tavily_extract

Tavily liefert strukturierte, für die Nutzung durch LLMs optimierte Ergebnisse mit konfigurierbarer Suchtiefe, Themenfilterung, Domainfiltern, KI-generierten Antwortzusammenfassungen und Inhaltsextraktion aus URLs (einschließlich mit JavaScript gerenderter Seiten).

Eigenschaft	Wert
Plugin-ID	`tavily`
Paket	`@openclaw/tavily-plugin`
Authentifizierung	Umgebungsvariable `TAVILY_API_KEY` oder Konfiguration `apiKey`
Basis-URL	`https://api.tavily.com` (Standard); Umgebungsvariable `TAVILY_BASE_URL` oder Konfiguration `baseUrl` zum Überschreiben
Zeitüberschreitungen	30s für die Suche, 60s für die Extraktion (Standard)
Werkzeuge	`tavily_search`, `tavily_extract`

Erste Schritte

Plugin installieren

openclaw plugins install @openclaw/tavily-plugin

API-Schlüssel abrufen

Erstellen Sie unter tavily.com ein Tavily-Konto und generieren Sie anschließend im Dashboard einen API-Schlüssel.

Plugin und Provider 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",
      },
    },
  },
}

Ausführung der Suche überprüfen

Lösen Sie über einen beliebigen Agenten eine web_search aus oder rufen Sie tavily_search direkt auf.

Wenn Sie Tavily beim Onboarding oder in openclaw configure --section web auswählen, wird das offizielle Tavily-Plugin bei Bedarf installiert und aktiviert.

Werkzeugreferenz

`tavily_search`

Verwenden Sie dies, wenn Sie statt der generischen web_search Tavily-spezifische Suchoptionen benötigen.

Parameter	Typ	Einschränkungen / Standard	Beschreibung
`query`	Zeichenfolge	erforderlich	Suchanfrage.
`search_depth`	Aufzählung	`basic` (Standard), `advanced`	`advanced` ist langsamer, bietet aber eine höhere Relevanz.
`topic`	Aufzählung	`general` (Standard), `news`, `finance`	Nach Themenbereich filtern.
`max_results`	Ganzzahl	1-20, Standard `5`	Anzahl der Ergebnisse.
`include_answer`	boolescher Wert	Standard `false`	Eine von Tavily KI-generierte Antwortzusammenfassung einbeziehen.
`time_range`	Aufzählung	`day`, `week`, `month`, `year`	Ergebnisse nach Aktualität filtern.
`include_domains`	Zeichenfolgen-Array	(keine)	Nur Ergebnisse aus diesen Domains einbeziehen.
`exclude_domains`	Zeichenfolgen-Array	(keine)	Ergebnisse aus diesen Domains ausschließen.

Abwägung bei der Suchtiefe:

Tiefe	Geschwindigkeit	Relevanz	Am besten geeignet für
`basic`	Schneller	Hoch	Allgemeine Suchanfragen (Standard).
`advanced`	Langsamer	Am höchsten	Präzise Recherche und Faktenfindung.

`tavily_extract`

Verwenden Sie dies, um bereinigte Inhalte aus einer oder mehreren URLs zu extrahieren. Das Werkzeug verarbeitet mit JavaScript gerenderte Seiten und unterstützt eine anfragebezogene Segmentierung für die gezielte Extraktion.

Parameter	Typ	Einschränkungen / Standard	Beschreibung
`urls`	Zeichenfolgen-Array	erforderlich, 1-20	URLs, aus denen Inhalte extrahiert werden sollen.
`query`	Zeichenfolge	(optional)	Extrahierte Abschnitte nach ihrer Relevanz für diese Anfrage neu sortieren.
`extract_depth`	Aufzählung	`basic` (Standard), `advanced`	Verwenden Sie `advanced` für JS-lastige Seiten, SPAs oder dynamische Tabellen.
`chunks_per_source`	Ganzzahl	1-5; erfordert `query`	Pro URL zurückgegebene Abschnitte. Führt zu einem Fehler, wenn der Parameter ohne `query` festgelegt wird.
`include_images`	boolescher Wert	Standard `false`	Bild-URLs in die Ergebnisse einbeziehen.

Abwägung bei der Extraktionstiefe:

Tiefe	Verwendungszweck
`basic`	Einfache Seiten. Versuchen Sie dies zuerst.
`advanced`	Mit JS gerenderte SPAs, dynamische Inhalte und Tabellen.

Teilen Sie größere URL-Listen auf mehrere tavily_extract-Aufrufe auf (maximal 20 pro Anfrage). Verwenden Sie query zusammen mit chunks_per_source, um statt vollständiger Seiten nur relevante Inhalte abzurufen.

Das richtige Werkzeug auswählen

Anforderung	Werkzeug
Schnelle Websuche ohne besondere Optionen	`web_search`
Suche mit Tiefe, Thema und KI-Antworten	`tavily_search`
Inhalte aus bestimmten URLs extrahieren	`tavily_extract`

Das generische Werkzeug web_search unterstützt mit Tavily als Provider query und count (bis zu 20 Ergebnisse). Verwenden Sie für Tavily-spezifische Optionen (search_depth, topic, include_answer, Domainfilter, Zeitraum) stattdessen tavily_search.

Erweiterte Konfiguration

Auflösungsreihenfolge für API-Schlüssel

Der Tavily-Client sucht seinen API-Schlüssel in dieser Reihenfolge:

plugins.entries.tavily.config.webSearch.apiKey (über SecretRefs aufgelöst).
TAVILY_API_KEY aus der Gateway-Umgebung.

tavily_search und tavily_extract lösen beide einen Einrichtungsfehler aus, wenn keiner der Werte vorhanden ist.

Benutzerdefinierte Basis-URL

Überschreiben Sie plugins.entries.tavily.config.webSearch.baseUrl oder legen Sie TAVILY_BASE_URL fest, wenn Sie Tavily über einen Proxy bereitstellen. Die Konfiguration hat Vorrang vor der Umgebungsvariable. Der Standardwert ist https://api.tavily.com.

`chunks_per_source` erfordert `query`

tavily_extract lehnt Aufrufe ab, die chunks_per_source ohne query übergeben. Tavily ordnet Abschnitte nach ihrer Relevanz für die Anfrage, daher ist der Parameter ohne eine solche Anfrage bedeutungslos.

Übersicht zur Websuche

Alle Provider und Regeln zur automatischen Erkennung.

Firecrawl

Suche und Scraping mit Inhaltsextraktion.

Exa Search

Neuronale Suche mit Inhaltsextraktion.

Konfiguration

Vollständiges Konfigurationsschema für Plugin-Einträge und Werkzeug-Routing.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Erste Schritte

Werkzeugreferenz

`tavily_search`

`tavily_extract`

Das richtige Werkzeug auswählen

Erweiterte Konfiguration

Verwandte Themen

Übersicht zur Websuche

Firecrawl

Exa Search

Konfiguration

​Erste Schritte

​Werkzeugreferenz

​tavily_search

​tavily_extract

​Das richtige Werkzeug auswählen

​Erweiterte Konfiguration

​Verwandte Themen

Übersicht zur Websuche

Firecrawl

Exa Search

Konfiguration

Erste Schritte

Werkzeugreferenz

`tavily_search`

`tavily_extract`

Das richtige Werkzeug auswählen

Erweiterte Konfiguration

Verwandte Themen