Tools
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_searchundtavily_extract
Tavily liefert strukturierte, für die Verarbeitung 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 |
| Zeitlimits | 30 s für die Suche, 60 s für die Extraktion (Standard) |
| Werkzeuge | tavily_search, tavily_extract |
Erste Schritte
Plugin installieren
openclaw plugins install @openclaw/tavily-pluginAPI-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, wenn TAVILY_API_KEY festgelegt ist 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.
Werkzeugreferenz
tavily_search
Verwenden Sie dieses Werkzeug, wenn Sie statt der generischen web_search Tavily-spezifische Suchoptionen benötigen.
| Parameter | Typ | Einschränkungen / Standard | Beschreibung |
|---|---|---|---|
query |
Zeichenfolge | erforderlich | Zeichenfolge der Suchanfrage. |
search_depth |
Aufzählung | basic (Standard), advanced |
advanced ist langsamer, liefert aber relevantere Ergebnisse. |
topic |
Aufzählung | general (Standard), news, finance |
Nach Themenbereich filtern. |
max_results |
Ganzzahl | 1–20, Standard 5 |
Anzahl der Ergebnisse. |
include_answer |
Boolesch | 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 Recherchen und Faktenprüfung. |
tavily_extract
Verwenden Sie dieses Werkzeug, um bereinigte Inhalte aus einer oder mehreren URLs zu extrahieren. Es verarbeitet mit JavaScript gerenderte Seiten und unterstützt die an Suchanfragen ausgerichtete Segmentierung für eine 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 Segmente nach ihrer Relevanz für diese Anfrage neu sortieren. |
extract_depth |
Aufzählung | basic (Standard), advanced |
Verwenden Sie advanced für stark JS-basierte Seiten, SPAs oder dynamische Tabellen. |
chunks_per_source |
Ganzzahl | 1–5; erfordert query |
Pro URL zurückgegebene Segmente. Führt ohne query zu einem Fehler. |
include_images |
Boolesch | Standard false |
Bild-URLs in die Ergebnisse einbeziehen. |
Abwägung bei der Extraktionstiefe:
| Tiefe | Verwendung |
|---|---|
basic |
Einfache Seiten. Probieren Sie dies zuerst aus. |
advanced |
Mit JS gerenderte SPAs, dynamische Inhalte und Tabellen. |
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 |
Erweiterte Konfiguration
Auflösungsreihenfolge des API-Schlüssels
Der Tavily-Client sucht in dieser Reihenfolge nach seinem API-Schlüssel:
plugins.entries.tavily.config.webSearch.apiKey(über SecretRefs aufgelöst).TAVILY_API_KEYaus der Gateway-Umgebung.
Sowohl tavily_search als auch tavily_extract lösen einen Einrichtungsfehler aus, wenn keines von beiden 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 Umgebungsvariablen. Der Standardwert ist https://api.tavily.com.
`chunks_per_source` erfordert `query`
tavily_extract weist Aufrufe zurück, die chunks_per_source ohne query übergeben. Tavily ordnet Segmente nach ihrer Relevanz für die Suchanfrage, daher ist der Parameter ohne eine solche bedeutungslos.
