# Усунення неполадок

Поширені проблеми та способи їх вирішення.

---

## Проблеми з Gateway

### Gateway не запускається

- **Конфлікт портів**, Інший процес може використовувати порт 18789. Перевірте командою `lsof -i :18789`.
- **Помилка конфігурації**, Невалідний JSON у файлі `neotask.json`. Gateway перевіряє конфігурацію при запуску та повідомляє конкретні помилки.
- **Блокування Gateway**, Попередній екземпляр міг залишити застарілий файл блокування. Інструмент діагностики може виявити та усунути це.
- **Версія Node.js**, Neotask вимагає Node 22+.

### Gateway запускається, але канали не підключаються

- **Відсутні облікові дані**, Кожен канал потребує власної аутентифікації (токен бота, сканування QR, API-ключ).
- **Мережеві проблеми**, Канали потребують доступу до Інтернету для підключення до API платформ обміну повідомленнями.
- **Ліміти запитів**, Деякі платформи обмежують нові підключення. Зачекайте та спробуйте знову.

### Неможливо підключитися з настільного застосунку

- **Неправильний порт**, Переконайтеся, що настільний застосунок підключається до правильного порту Gateway.
- **Невідповідність аутентифікації**, Токен Gateway повинен відповідати.
- **Брандмауер**, Переконайтеся, що порт доступний, якщо Gateway знаходиться на іншій машині.

---

## Проблеми з каналами

### WhatsApp не підключається

- **QR-код прострочено**, QR-коди дійсні близько 60 секунд. Скануйте швидко.
- **Ліміт пов'язаних пристроїв**, WhatsApp обмежує кількість пов'язаних пристроїв.
- **Сесія пошкоджена**, Видаліть директорію сесії WhatsApp та виконайте повторне спарювання.

### Telegram-бот не отримує повідомлення

- **Невалідний токен бота**, Перевірте токен бота за допомогою BotFather.
- **Режим конфіденційності**, За замовчуванням боти бачать повідомлення лише при згадці в групах.
- **Конфлікт вебхуків**, Інший сервіс може споживати повідомлення.

### Discord-бот не відповідає

- **Відсутні наміри**, Увімкніть необхідні Gateway Intents на Discord Developer Portal.
- **Відсутні дозволи**, Бот потребує прав читання та надсилання у цільових каналах.

---

## Проблеми з моделями

### Помилки аутентифікації

- **Ключ не налаштовано**, Переконайтеся, що API-ключ провайдера встановлено.
- **Ключ прострочено**, Деякі OAuth-токени закінчуються. Виконайте повторну аутентифікацію.
- **Ліміт запитів**, Ротація ключів автоматично перемкнеться, якщо у вас є кілька ключів.

### Повільні відповіді

- **Вибір моделі**, Більші моделі повільніші. Спробуйте швидшу модель для простих завдань.
- **Розмір контексту**, Довгі розмови сповільнюють обробку. Спробуйте `/compact`.
- **Мережева затримка**, Перевірте підключення до вашого провайдера моделей.

---

## Проблеми з вузлами

### Додаток-компаньйон не може знайти Gateway

- **Режим прив'язки**, Gateway повинен бути прив'язаний до локальної мережі або Tailnet (не до зворотної петлі) для зовнішніх пристроїв.
- **Та сама мережа**, Для виявлення через Bonjour обидва пристрої повинні знаходитися в одній мережі.
- **Ручне введення**, Вручну введіть хост та порт Gateway в налаштуваннях застосунку.

---

## Проблеми з сесіями

### Перевищено контекстне вікно

- **Ущільнення**, Використовуйте `/compact` для підсумування та скидання контексту.
- **Увімкніть автоматичне ущільнення**, Встановіть поріг ущільнення в конфігурації.
- **Нова сесія**, Почніть з початку командою `/new`.

---

## Діагностика

Вбудований інструмент діагностики перевіряє поширені проблеми та може усунути багато з них автоматично:

- Перевірка конфігурації
- Дозволи на файли
- Підключення каналів
- Статус аутентифікації моделі
- Сумісність Node.js
- Конфігурація мережі

Перевірте журнали Gateway для отримання детальної інформації про помилки. Кінцева точка `/health` надає стан всіх компонентів у машиночитаному форматі.

---

## Отримання допомоги

1. Запустіть інструмент діагностики для автоматичного усунення проблем
2. Перевірте журнали Gateway для детальних повідомлень про помилки
3. Зверніться до підтримки через віджет чату Intercom у настільному застосунку