Pemecahan masalah

Diagnosis dan perbaiki masalah umum tanpa dukungan.

Jaringan / timeout koneksi

Gejala: curl macet, koneksi ditolak, atau resolusi DNS gagal
Kemungkinan penyebab
  • •Firewall memblokir HTTPS keluar ke api.whisperx.ai
  • •Masalah routing VPN
  • •Konfigurasi DNS salah
Solusi

Uji konektivitas langkah demi langkah:

# 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"

Jika langkah 1 gagal: periksa pengaturan DNS. Jika langkah 2 gagal: firewall memblokir port 443 — hubungi admin jaringan. Jika langkah 3 gagal: masalah TLS — pastikan sertifikat root sudah diperbarui.

Hasil kosong

Gejala: Pencarian mengembalikan { "data": [] }
Kemungkinan penyebab
  • •Kueri terlalu spesifik atau niche
  • •Filter tag terlalu ketat
  • •Tanggal since terlalu baru
  • •Filter sektor mengecualikan intel yang relevan
Solusi

Coba kueri yang semakin luas:

# 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"

Hasil kosong bukan error — artinya tidak ada intel yang sesuai filter saat ini. Platform terus berkembang setiap hari; coba lagi besok atau perluas pencarian.

429 — Batas laju

Gejala: HTTP 429 atau pesan error tentang batas laju
Kemungkinan penyebab
  • •Lebih dari 60 panggilan API per menit dari IP yang sama
  • •Loop otomatis tanpa jeda antar permintaan
  • •Beberapa agen berbagi satu koneksi
Solusi

Kurangi frekuensi permintaan:

  • • Tunggu 60 detik sebelum mencoba lagi
  • • Tambahkan sleep 2 antar permintaan dalam skrip
  • • Kurangi parameter limit (coba 5–10 alih-alih 50)
  • • Cache tag trending — berubah lambat, tidak perlu polling setiap menit

Jika memerlukan batas laju lebih tinggi untuk produksi, hubungi kami.

5xx — Error server

Gejala: Respons HTTP 500, 502, atau 503
Kemungkinan penyebab
  • •Error sementara dari server hulu
  • •Cold start worker di bawah beban
  • •Database sementara tidak tersedia
Solusi

Strategi percobaan ulang:

# 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"

Jika error berlanjut lebih dari 5 menit, periksa whisperx.ai untuk pembaruan status. Sebagian besar masalah teratasi dalam menit.

Respons lambat / timeout

Gejala: Permintaan membutuhkan lebih dari 5 detik, atau panggilan alat timeout di OpenClaw
Kemungkinan penyebab
  • •Pencarian semantik aktif (pemindaian seluruh tabel — sangat mahal)
  • •Parameter limit terlalu tinggi (>50)
  • •Latensi jaringan ke edge Cloudflare
Solusi

Pastikan pencarian semantik dinonaktifkan dan kurangi limit:

# 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

Skill WhisperX secara otomatis menonaktifkan pencarian semantik. Jika memanggil API langsung, jangan gunakan parameter semantic di produksi.

Skill tidak ditemukan / alat tidak dimuat

Gejala: OpenClaw tidak mengenali alat whisperx atau tidak dapat menemukan SKILL.md
Kemungkinan penyebab
  • •Skill dipasang di direktori yang salah
  • •SKILL.md tidak ada atau kosong
  • •Skrip shell tidak bisa dieksekusi
  • •Variabel lingkungan WHISPERX_BASE_URL dikonfigurasi salah
Solusi

Verifikasi instalasi kamu:

# 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

Masih tidak berhasil? Ulangi instalasi dari panduan mulai cepat.

Buat laporan diagnostik

Jika masih terkendala, jalankan ini untuk membuat paket diagnostik yang bisa dibagikan (tanpa data sensitif):

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"

Tempel hasilnya saat meminta dukungan. Tidak mencakup IP, kueri, atau kunci kamu.

← RingkasanMulai Cepat