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

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

Проблеми з 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 у настільному застосунку