Tavily Web Search Skill für OpenClaw

OpenClaw Tavily Web Search Skill Überblick

Der Tavily Web Search Skill verbindet OpenClaw mit der Tavily Search API, einer KI-optimierten Suchmaschine, die speziell für KI-Agenten und LLM-Anwendungen entwickelt wurde. Im Gegensatz zu herkömmlichen Such-APIs, die nur unverarbeitete Links zurückgeben, analysiert Tavily mehrere Quellen und liefert strukturierte, relevante Inhalte, die Ihr OpenClaw-Agent sofort verwenden kann.

Tavily unterstützt die Suche für über 1 Million Entwickler und verarbeitet mehr als 100 Millionen Anfragen pro Monat. Es genießt das Vertrauen von OpenAI, Anthropic, LangChain und anderen führenden KI-Plattformen. Mit SOC-2-Zertifizierung, keinerlei Datenspeicherung und integriertem Schutz vor Prompt Injection ist es eine der sichersten Möglichkeiten, Ihrem Agenten Webzugang zu gewähren.

Typischer Workflow:

1. Stellen Sie OpenClaw eine Frage, die aktuelle Informationen erfordert.
2. Der Agent ruft die Tavily API mit einer optimierten Suchanfrage auf.
3. Tavily durchsucht das Web, extrahiert relevante Inhalte aus mehreren Quellen und gibt eine strukturierte Zusammenfassung mit Quellenangaben zurück — alles in unter 2 Sekunden.

Dieser Skill ist ideal für Recherche-Aufgaben, Faktenprüfung, Abfrage aktueller Ereignisse und jeden Workflow, bei dem Ihr Agent Zugriff auf Informationen jenseits seiner Trainingsdaten benötigt. Er lässt sich gut mit dem Brave Search Skill für datenschutzorientierte Anfragen und dem DeepWiki Skill für Repository-Dokumentationsrecherche kombinieren.

Voraussetzungen für den Tavily Web Search Skill

Bevor Sie den Tavily Web Search Skill installieren, stellen Sie sicher, dass Sie Folgendes haben:

• OpenClaw installiert und laufend (v1.0+)
• Einen Tavily API-Schlüssel — Registrierung unter tavily.com (kostenlose Stufe enthält 1.000 Credits/Monat)
• clawhub CLI installiert für die Skill-Verwaltung

Überprüfen Sie Ihr Setup:

# OpenClaw-Version prüfen
openclaw --version

# Bestätigen, dass Ihr Tavily API-Schlüssel gesetzt ist
echo $TAVILY_API_KEY

Es ist keine zusätzliche Softwareinstallation erforderlich. Der Skill kommuniziert mit Tavilys Cloud-API, sodass es neben OpenClaw selbst keine lokalen Abhängigkeiten gibt.

So Installieren Sie den Tavily Web Search Skill

Installieren Sie den Tavily Web Search Skill mit einem einzigen Befehl:

npx clawhub@latest install tavily-web-search

Um die Installation zu überprüfen:

clawhub list

Sie sollten tavily-web-search in der Liste der installierten Skills sehen.

Tavily Web Search Skill Konfiguration

Der Skill benötigt einen Tavily API-Schlüssel zur Authentifizierung. Sie können einen kostenlosen Schlüssel unter app.tavily.com erhalten.

API-Schlüssel einrichten

# Ihren Tavily API-Schlüssel als Umgebungsvariable setzen
export TAVILY_API_KEY=tvly-your-api-key-here

Um dies dauerhaft zu machen, fügen Sie die Export-Zeile zu Ihrem Shell-Profil hinzu (~/.bashrc, ~/.zshrc oder entsprechend).

Suchmodi

Der Skill unterstützt zwei Suchtiefen und zwei Themenmodi, die Sie je nach Bedarf kombinieren können:

| Modus | Geschwindigkeit | Abdeckung | Ideal für | |-------|-----------------|-----------|-----------| | Basic | 1-2 Sekunden | Gut | Schnelle Fakten, einfache Abfragen | | Advanced | 5-10 Sekunden | Hervorragend | Komplexe Recherche, umfassende Antworten |

| Thema | Umfang | Ideal für | |-------|--------|-----------| | General | Alle Webinhalte | Zeitlose Themen, Dokumentation, Tutorials | | News | Letzte 7 Tage, Nachrichtenquellen | Aktuelle Ereignisse, Eilmeldungen, Markt-Updates |

Der Agent wählt automatisch den passenden Modus basierend auf Ihrer Anfrage, aber Sie können dies überschreiben, indem Sie in Ihrem Prompt "führe eine tiefgehende Suche durch" oder "suche aktuelle Nachrichten" angeben.

Wichtig: Codieren Sie Ihren API-Schlüssel niemals fest in Konfigurationsdateien und committen Sie ihn nicht in die Versionskontrolle. Verwenden Sie Umgebungsvariablen oder einen Geheimnis-Manager wie 1Password.

Tavily Web Search Skill Anwendungsbeispiele

1. Schnelle Faktenabfrage

Du: "Was ist die neueste stabile Version von Next.js?"

Der Agent führt eine einfache Tavily-Suche durch, extrahiert die Versionsnummer aus offiziellen Quellen und gibt eine prägnante Antwort mit einem Link zu den Next.js-Versionshinweisen zurück.

2. Tiefgehende Recherche

Du: "Vergleiche die Vor- und Nachteile von Server-Side Rendering gegenüber Static Site Generation für E-Commerce-Websites."

Der Agent führt eine erweiterte Suche durch, fasst Erkenntnisse aus mehreren Blogbeiträgen, Dokumentationsseiten und Fallstudien zusammen und liefert einen strukturierten Vergleich mit Quellenangaben für jeden Punkt.

3. Aktuelle Ereignisse und Nachrichten

Du: "Was ist diese Woche in der KI-Branche passiert?"

Der Agent wechselt in den Nachrichtenmodus, durchsucht die letzten 7 Tage und gibt eine Zusammenfassung der wichtigsten KI-Nachrichten mit Links zu den Originalartikeln zurück.

4. Domainspezifische Recherche

Du: "Suche nur auf MDN und in den TypeScript-Docs nach der Verwendung von Template Literal Types."

Der Agent verwendet Domain-Filterung, um nur developer.mozilla.org und typescriptlang.org einzubeziehen, sodass die Ergebnisse ausschließlich aus autoritativen Quellen stammen.

5. Inhaltsextraktion

Du: "Extrahiere den vollständigen Inhalt der Tavily API-Preisseite und fasse die Stufen zusammen."

Der Agent nutzt die Rohinhalt-Extraktion, um den vollständigen Seiteninhalt abzurufen, und erstellt dann eine strukturierte Aufschlüsselung jeder Preisstufe mit Funktionen und Limits.

Sicherheit und Best Practices

Befolgen Sie diese Richtlinien bei der Verwendung des Tavily Web Search Skills:

• Schützen Sie Ihren API-Schlüssel. Speichern Sie ihn in einer Umgebungsvariable oder einem Geheimnis-Manager. Teilen Sie ihn niemals in Chat-Protokollen, committen Sie ihn nicht in Git und legen Sie ihn nicht in clientseitigem Code offen.
• Behandeln Sie Suchergebnisse als nicht vertrauenswürdige Eingabe. Webinhalte können ungenaue, veraltete oder manipulierte Informationen enthalten. Überprüfen Sie kritische Fakten immer aus mehreren Quellen, bevor Sie darauf basierend handeln. Lesen Sie die Sicherheits-Checkliste für allgemeine Hinweise.
• Überwachen Sie Ihre Nutzung. Die kostenlose Stufe bietet 1.000 Credits pro Monat. Jede einfache Suche kostet 1 Credit und erweiterte Suchen kosten 2 Credits. Überprüfen Sie Ihre Nutzung unter app.tavily.com, um unerwartete Überschreitungen zu vermeiden.
• Verwenden Sie Domain-Filterung für sensible Anfragen. Wenn Genauigkeit wichtig ist, beschränken Sie die Ergebnisse auf vertrauenswürdige Domains (offizielle Dokumentation, Regierungsseiten, etablierte Publikationen) mithilfe von Include-Domain-Filtern.
• Beachten Sie Rate Limits. Vermeiden Sie schnell aufeinanderfolgende Anfragen in Schleifen. Der Skill handhabt Rate Limiting elegant, aber übermäßige Anfragen können Ihren Zugang vorübergehend drosseln.

Fehlerbehebung Häufiger Fehler

"Invalid API key"

Ihr Tavily API-Schlüssel fehlt, ist fehlerhaft oder abgelaufen.

1. Überprüfen Sie, ob der Schlüssel gesetzt ist: echo $TAVILY_API_KEY
2. Stellen Sie sicher, dass er mit tvly- beginnt — Schlüssel von Tavily verwenden immer dieses Präfix.
3. Wenn der Schlüssel korrekt ist, aber dennoch fehlschlägt, generieren Sie einen neuen unter app.tavily.com.

"Rate limit exceeded"

Sie haben das Anfragelimit für Ihre Planstufe überschritten.

1. Überprüfen Sie Ihre aktuelle Nutzung unter app.tavily.com.
2. Wenn Sie die kostenlose Stufe nutzen, warten Sie bis zum monatlichen Reset am 1. des nächsten Monats.
3. Erwägen Sie ein Upgrade auf einen kostenpflichtigen Plan für höhere Limits, oder optimieren Sie Ihre Anfragen, indem Sie den einfachen Modus verwenden, wo der erweiterte nicht benötigt wird.

"No results found"

Die Anfrage hat keine passenden Ergebnisse zurückgegeben. Dies kann bei sehr speziellen oder hochspezifischen Suchen vorkommen.

1. Erweitern Sie Ihre Suchbegriffe — entfernen Sie übermäßig spezifische Filter.
2. Wenn Sie Domain-Filterung verwenden, stellen Sie sicher, dass die Ziel-Domains tatsächlich relevante Inhalte enthalten.
3. Versuchen Sie, vom Nachrichtenmodus in den allgemeinen Modus zu wechseln, wenn das Thema kein aktuelles Ereignis ist.