Fehlerbehebung

Häufige Probleme ohne Support diagnostizieren und beheben.

Netzwerk / Verbindungstimeout

Symptom: curl hängt, Verbindung abgelehnt oder DNS-Auflösung schlägt fehl
Mögliche Ursachen
  • •Netzwerk-Firewall blockiert ausgehenden HTTPS zu api.whisperx.ai
  • •VPN-Routing-Probleme
  • •DNS-Fehlkonfiguration
Lösung

Verbindung schrittweise testen:

# 1. DNS resolution
nslookup api.whisperx.ai

# 2. TCP port 443
nc -zv api.whisperx.ai 443

# 3. HTTPS GET
curl -v --max-time 5 "https://api.whisperx.ai/api/tags/trending"

Schritt 1 schlägt fehl: DNS-Einstellungen prüfen. Schritt 2 schlägt fehl: Firewall blockiert Port 443 — Netzwerkadministrator kontaktieren. Schritt 3 schlägt fehl: TLS-Problem — sicherstellen, dass das System aktuelle Root-Zertifikate hat.

Leere Ergebnisse

Symptom: Suche gibt { "data": [] } zurück
Mögliche Ursachen
  • •Abfrage zu spezifisch oder nischenartig
  • •Tag-Filter zu restriktiv
  • •since-Datum zu aktuell
  • •Sektorfilter schließt passende Intelligence aus
Lösung

Progressiv breitere Abfragen versuchen:

# Remove tag filter
curl "https://api.whisperx.ai/api/intel?q=OpenAI&limit=10"

# Remove sector filter
curl "https://api.whisperx.ai/api/intel?q=layoff&limit=10"

# Extend time window (no since filter)
curl "https://api.whisperx.ai/api/intel?q=funding&limit=10"

# Try trending tags to see what's active
curl "https://api.whisperx.ai/api/tags/trending?limit=20"

Leere Ergebnisse sind kein Fehler — sie bedeuten, dass aktuell keine Intelligence Ihren Filtern entspricht. Die Plattform wächst täglich; morgen nochmal versuchen oder Suche erweitern.

429 — Rate-Limit erreicht

Symptom: HTTP 429 oder Fehlermeldung mit Hinweis auf Rate-Limit
Mögliche Ursachen
  • •Mehr als 60 API-Aufrufe pro Minute von derselben IP
  • •Automatisierte Schleife ohne Verzögerung zwischen Anfragen
  • •Mehrere Agenten teilen eine Verbindung
Lösung

Zurückhalten und Frequenz reduzieren:

  • • 60 Sekunden warten vor erneutem Versuch
  • • sleep 2 zwischen Anfragen in Skripten hinzufügen
  • • limit-Parameter reduzieren (5–10 statt 50 versuchen)
  • • Trendige Tags cachen — ändern sich langsam, kein minütliches Polling nötig

Für höhere Rate-Limits im Produktionsbetrieb kontaktieren Sie uns.

5xx — Serverfehler

Symptom: HTTP 500, 502 oder 503 Antwort
Mögliche Ursachen
  • •Vorübergehender Upstream-Fehler
  • •Worker-Kaltstart unter Last
  • •Datenbank vorübergehend nicht verfügbar
Lösung

Wiederholungsstrategie:

# Retry once after 10 seconds
sleep 10 && curl "https://api.whisperx.ai/api/intel?q=test&limit=1"

# If 5xx persists, fall back to trending tags (lighter endpoint)
curl "https://api.whisperx.ai/api/tags/trending?limit=10"

Falls Fehler länger als 5 Minuten anhalten, prüfen whisperx.ai für Statusupdates. Die meisten Probleme lösen sich innerhalb von Minuten.

Langsame Antworten / Timeouts

Symptom: Anfragen dauern länger als 5 Sekunden oder Tool-Aufrufe in OpenClaw laufen in Timeout
Mögliche Ursachen
  • •Semantische Suche aktiviert (vollständiger Tabellenscan — sehr aufwendig)
  • •limit zu hoch eingestellt (>50)
  • •Netzwerklatenz zum Cloudflare-Edge
Lösung

Semantische Suche deaktivieren und limit senken:

# Good: keyword search, compact mode, small limit
curl "https://api.whisperx.ai/api/intel?q=OpenAI&mode=compact&limit=10"

# Bad: semantic search (avoid — full-table scan)
# /api/intel?semantic=... ← do NOT use this

Die WhisperX-Skill deaktiviert die semantische Suche automatisch. Beim direkten API-Aufruf niemals den semantic-Parameter in der Produktion verwenden.

Skill nicht gefunden / Tools laden nicht

Symptom: OpenClaw erkennt whisperx-Tools nicht oder findet SKILL.md nicht
Mögliche Ursachen
  • •Skill in falschem Verzeichnis installiert
  • •SKILL.md fehlt oder ist leer
  • •Shell-Skripte nicht ausführbar
  • •Umgebungsvariable WHISPERX_BASE_URL falsch gesetzt
Lösung

Installation überprüfen:

# Check skill files exist
ls ~/.claude/skills/whisperx/
# Expected: SKILL.md  tools/

ls ~/.claude/skills/whisperx/tools/
# Expected: search.sh  get.sh  trending.sh  trends.sh  connections.sh  export.sh

# Check scripts are executable
ls -la ~/.claude/skills/whisperx/tools/*.sh
# Should show -rwxr-xr-x permissions

# Fix permissions if needed
chmod +x ~/.claude/skills/whisperx/tools/*.sh

# Quick smoke test
bash ~/.claude/skills/whisperx/tools/trending.sh 5

Immer noch nicht? Installation neu starten über die Schnellstart-Anleitung.

Diagnosebericht erstellen

Noch nicht weitergekommen? Diesen Befehl ausführen, um ein teilbares Diagnose-Bundle zu erstellen (keine sensiblen Daten):

echo "=== WhisperX Diagnostic ===" && \
echo "Date: $(date -u)" && \
echo "OS: $(uname -a)" && \
echo " && \
echo "--- Connectivity ---" && \
curl -s -o /dev/null -w "HTTP %{http_code} | Time %{time_total}s" \
  "https://api.whisperx.ai/api/tags/trending?limit=1" && \
echo " && \
echo "--- Skill files ---" && \
ls -la ~/.claude/skills/whisperx/tools/ 2>/dev/null || echo "Skill not installed"

Die Ausgabe beim Support-Antrag einfügen. Enthält keine IP, Abfragen oder Schlüssel.

← ÜbersichtSchnellstart