Pemecahan Masalah

Masalah umum dan cara mengatasinya.

Masalah Gateway

Gateway tidak mau mulai

• Konflik port, Proses lain mungkin menggunakan port 18789. Periksa dengan lsof -i :18789.
• Kesalahan konfigurasi, JSON tidak valid di neotask.json. Gateway memvalidasi konfigurasi saat startup dan melaporkan kesalahan spesifik.
• Kunci Gateway, Instans sebelumnya mungkin telah meninggalkan file kunci yang sudah tidak berlaku. Alat diagnostik dapat mendeteksi dan memperbaiki ini.
• Versi Node.js, Neotask memerlukan Node 22+.

Gateway mulai tetapi tidak ada saluran yang terhubung

• Kredensial hilang, Setiap saluran memerlukan autentikasi sendiri (token bot, pemindaian QR, kunci API).
• Masalah jaringan, Saluran memerlukan akses internet untuk terhubung ke API platform pesan.
• Batas kecepatan, Beberapa platform membatasi kecepatan koneksi baru. Tunggu dan coba lagi.

Tidak dapat terhubung dari aplikasi desktop

• Port salah, Pastikan aplikasi desktop terhubung ke port Gateway yang benar.
• Ketidakcocokan auth, Token Gateway harus cocok.
• Firewall, Pastikan port dapat diakses jika Gateway berada di mesin lain.

Masalah Saluran

WhatsApp tidak mau terhubung

• QR kedaluwarsa, Kode QR kedaluwarsa setelah ~60 detik. Pindai ulang dengan cepat.
• Batas multi-perangkat, WhatsApp membatasi perangkat yang ditautkan.
• Sesi rusak, Hapus direktori sesi WhatsApp dan pasangkan ulang.

Bot Telegram tidak menerima pesan

• Token bot tidak valid, Verifikasi token bot Anda dengan BotFather.
• Mode privasi, Bot hanya melihat pesan ketika disebutkan dalam grup secara default.
• Konflik webhook, Layanan lain mungkin mengonsumsi pesan.

Bot Discord tidak merespons

• Intents hilang, Aktifkan Gateway Intents yang diperlukan di Discord Developer Portal.
• Izin hilang, Bot memerlukan izin baca dan kirim di saluran target.

Masalah Model

Kesalahan autentikasi

• Kunci tidak dikonfigurasi, Pastikan kunci API penyedia telah diatur.
• Kunci kedaluwarsa, Beberapa token OAuth kedaluwarsa. Autentikasi ulang.
• Batas kecepatan, Rotasi kunci akan beralih secara otomatis jika Anda memiliki beberapa kunci.

Respons lambat

• Pilihan model, Model yang lebih besar lebih lambat. Coba model yang lebih cepat untuk tugas cepat.
• Ukuran konteks, Percakapan panjang memperlambat pemrosesan. Coba /compact.
• Latensi jaringan, Periksa konektivitas ke penyedia model Anda.

Masalah Node

Aplikasi pendamping tidak dapat menemukan Gateway

• Mode binding, Gateway harus terikat ke LAN atau Tailnet (bukan loopback) untuk perangkat eksternal.
• Jaringan yang sama, Untuk penemuan Bonjour, kedua perangkat harus berada di jaringan yang sama.
• Entri manual, Masukkan host dan port Gateway secara manual di pengaturan aplikasi.

Masalah Sesi

Jendela konteks terlampaui

• Compact, Gunakan /compact untuk merangkum dan mereset konteks.
• Aktifkan kompaksi otomatis, Atur ambang batas kompaksi di konfigurasi.
• Sesi baru, Mulai segar dengan /new.

Diagnostik

Alat diagnostik bawaan memeriksa masalah umum dan dapat memperbaiki banyak masalah secara otomatis:

• Validasi konfigurasi
• Izin file
• Konektivitas saluran
• Status auth model
• Kompatibilitas Node.js
• Konfigurasi jaringan

Periksa log Gateway untuk informasi kesalahan terperinci. Endpoint /health menyediakan status yang dapat dibaca mesin dari semua komponen.

Mendapatkan Bantuan

1. Jalankan alat diagnostik untuk perbaikan otomatis
2. Periksa log Gateway untuk pesan kesalahan terperinci
3. Hubungi dukungan melalui widget obrolan Intercom di aplikasi desktop