Устранение проблем

Диагностируйте и устраняйте распространённые проблемы без поддержки.

Сеть / таймаут подключения

Симптом: curl завис, соединение отклонено или DNS не разрешается
Возможные причины
  • •Файрвол блокирует исходящий HTTPS к api.whisperx.ai
  • •Проблемы с маршрутизацией 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 или сообщение об ошибке с упоминанием rate limit
Возможные причины
  • •Более 60 API-запросов в минуту с одного IP
  • •Автоматический цикл без задержки между запросами
  • •Несколько агентов делят одно соединение
Исправление

Отступите и снизьте частоту:

  • • Подождите 60 секунд перед повторной попыткой
  • • Добавьте sleep 2 между запросами в скриптах
  • • Уменьшите параметр limit (попробуйте 5–10 вместо 50)
  • • Кешируйте трендовые теги — они меняются медленно, не нужно опрашивать каждую минуту

Если вам нужны более высокие лимиты для продакшна, свяжитесь с нами.

5xx — Ошибка сервера

Симптом: HTTP 500, 502 или 503
Возможные причины
  • •Временная ошибка на стороне сервера
  • •Холодный старт воркера под нагрузкой
  • •База данных временно недоступна
Исправление

Стратегия повторных попыток:

# 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
Исправление

Отключите семантический поиск и снизьте 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 автоматически отключает семантический поиск. При прямых вызовах API никогда не используйте параметр semantic в продакшне.

Скилл не найден / инструменты не загружаются

Симптом: OpenClaw не распознаёт инструменты whisperx или не может найти SKILL.md
Возможные причины
  • •Скилл установлен в неверную директорию
  • •SKILL.md отсутствует или пуст
  • •Шелл-скрипты не исполняемые
  • •Переменная среды 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, запросы и ключи не включены.

← ОбзорБыстрый старт