समस्या निवारण

सहायता के बिना सामान्य समस्याओं का निदान और समाधान करें।

नेटवर्क / कनेक्शन टाइमआउट

लक्षण: curl रुक जाता है, कनेक्शन अस्वीकृत, या DNS रेज़ोल्यूशन विफल
संभावित कारण
  • •फ़ायरवॉल api.whisperx.ai पर आउटबाउंड HTTPS ब्लॉक कर रहा है
  • •VPN रूटिंग समस्याएं
  • •DNS गलत कॉन्फ़िगरेशन
समाधान

कनेक्टिविटी चरण-दर-चरण परीक्षण करें:

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

चरण 1 विफल: DNS सेटिंग जांचें। चरण 2 विफल: फ़ायरवॉल पोर्ट 443 ब्लॉक कर रहा है — नेटवर्क एडमिन से संपर्क करें। चरण 3 विफल: TLS समस्या — सुनिश्चित करें कि सिस्टम में अपडेट रूट सर्टिफिकेट हों।

खाली परिणाम

लक्षण: खोज { "data": [] } लौटाती है
संभावित कारण
  • •क्वेरी बहुत विशिष्ट या संकीर्ण है
  • •टैग फ़िल्टर बहुत प्रतिबंधात्मक
  • •since तारीख बहुत हाल की
  • •क्षेत्र फ़िल्टर मिलते-जुलते आइटम को बाहर कर रहा है
समाधान

क्रमशः व्यापक क्वेरी आज़माएं:

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

खाली परिणाम कोई त्रुटि नहीं — इसका मतलब है अभी आपके फ़िल्टर से कोई खुफिया जानकारी मेल नहीं खाती। प्लेटफॉर्म रोज़ बढ़ता है; कल फिर कोशिश करें या खोज विस्तृत करें।

429 — दर सीमित

लक्षण: HTTP 429 या दर सीमा का उल्लेख करने वाला त्रुटि संदेश
संभावित कारण
  • •एक ही IP से प्रति मिनट 60 से अधिक API कॉल
  • •अनुरोधों के बीच कोई देरी नहीं वाला स्वचालित लूप
  • •एक कनेक्शन साझा करने वाले कई एजेंट
समाधान

पीछे हटें और आवृत्ति कम करें:

  • • पुनः प्रयास से पहले 60 सेकेंड प्रतीक्षा करें
  • • स्क्रिप्ट में अनुरोधों के बीच sleep 2 जोड़ें
  • • limit पैरामीटर कम करें (50 की जगह 5-10 आज़माएं)
  • • ट्रेंडिंग टैग कैश करें — धीरे बदलते हैं, हर मिनट पोल करने की जरूरत नहीं

उत्पादन उपयोग के लिए उच्च दर सीमाओं की जरूरत हो तो, हमसे संपर्क करें.

5xx — सर्वर त्रुटि

लक्षण: HTTP 500, 502 या 503 प्रतिक्रिया
संभावित कारण
  • •अस्थायी अपस्ट्रीम त्रुटि
  • •लोड के तहत Worker कोल्ड स्टार्ट
  • •डेटाबेस अस्थायी रूप से अनुपलब्ध
समाधान

पुनः प्रयास की रणनीति:

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

अगर 5 मिनट से अधिक त्रुटियां जारी रहें, जांचें whisperx.ai स्टेटस अपडेट के लिए। अधिकांश समस्याएं मिनटों में हल हो जाती हैं।

धीमी प्रतिक्रियाएं / टाइमआउट

लक्षण: अनुरोधों में 5 सेकेंड से अधिक समय लगता है, या OpenClaw में टूल कॉल टाइमआउट हो जाती है
संभावित कारण
  • •सिमेंटिक सर्च चालू (पूरी टेबल स्कैन — बहुत महंगा)
  • •limit बहुत अधिक सेट (>50)
  • •Cloudflare edge तक नेटवर्क लेटेंसी
समाधान

सुनिश्चित करें सिमेंटिक सर्च बंद है और 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

WhisperX Skill स्वचालित रूप से सिमेंटिक सर्च बंद कर देती है। API सीधे कॉल करते समय, उत्पादन में semantic पैरामीटर कभी न उपयोग करें।

Skill नहीं मिली / टूल लोड नहीं हो रहे

लक्षण: OpenClaw whisperx टूल नहीं पहचानता या SKILL.md नहीं ढूंढ पाता
संभावित कारण
  • •Skill गलत डायरेक्टरी में इंस्टॉल हुई
  • •SKILL.md गायब या खाली है
  • •Shell स्क्रिप्ट निष्पादन योग्य नहीं
  • •WHISPERX_BASE_URL एनवायरनमेंट वेरिएबल गलत सेट
समाधान

अपनी इंस्टॉलेशन सत्यापित करें:

# 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

अभी भी काम नहीं कर रहा? से पुनः इंस्टॉल करें त्वरित शुरुआत गाइड.

डायग्नोस्टिक रिपोर्ट बनाएं

अभी भी अटके हैं? साझा करने योग्य डायग्नोस्टिक बंडल बनाने के लिए यह चलाएं (कोई संवेदनशील डेटा नहीं):

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"

सहायता मांगते समय आउटपुट पेस्ट करें। इसमें आपका IP, क्वेरी या keys नहीं हैं।

← अवलोकनत्वरित शुरुआत