# 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