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 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-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 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.
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. |
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 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_KEYaus 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.
