# Sorun Giderme

Yaygın sorunlar ve bunların nasıl çözüleceği.

---

## Gateway Sorunları

### Gateway başlamıyor

- **Port çakışması**, Başka bir süreç 18789 numaralı portu kullanıyor olabilir. `lsof -i :18789` ile kontrol edin.
- **Yapılandırma hatası**, `neotask.json` içinde geçersiz JSON. Gateway, başlatmada yapılandırmayı doğrular ve belirli hatalar raporlar.
- **Gateway kilidi**, Önceki bir örnek eski bir kilit dosyası bırakmış olabilir. Tanılama aracı bunu tespit edip düzeltebilir.
- **Node.js sürümü**, Neotask, Node 22+ gerektirir.

### Gateway başlıyor ama kanallar bağlanmıyor

- **Eksik kimlik bilgileri**, Her kanalın kendi kimlik doğrulamasına ihtiyacı vardır (bot token'ı, QR tarama, API anahtarı).
- **Ağ sorunları**, Kanalların mesajlaşma platformu API'lerine bağlanmak için internet erişimine ihtiyacı vardır.
- **Hız limitleri**, Bazı platformlar yeni bağlantıları hız sınırlamasına tabi tutar. Bekleyin ve yeniden deneyin.

### Masaüstü uygulamasından bağlanamıyorum

- **Yanlış port**, Masaüstü uygulamasının doğru Gateway portuna bağlandığından emin olun.
- **Kimlik doğrulama uyumsuzluğu**, Gateway token'ı eşleşmeli.
- **Güvenlik duvarı**, Gateway başka bir makinedeyse portun erişilebilir olduğundan emin olun.

---

## Kanal Sorunları

### WhatsApp bağlanmıyor

- **QR süresi doldu**, QR kodları ~60 saniye sonra sona erer. Hızlıca yeniden tarayın.
- **Çok cihaz limiti**, WhatsApp bağlı cihazları sınırlar.
- **Oturum bozuk**, WhatsApp oturum dizinini silin ve yeniden eşleştirin.

### Telegram botu mesaj almıyor

- **Bot token'ı geçersiz**, BotFather ile bot token'ınızı doğrulayın.
- **Gizlilik modu**, Botlar varsayılan olarak gruplarda yalnızca bahsedildiklerinde mesajları görür.
- **Webhook çakışması**, Başka bir hizmet mesajları tüketiyor olabilir.

### Discord botu yanıt vermiyor

- **Eksik amaçlar**, Discord Geliştirici Portalında gerekli Gateway Amaçlarını etkinleştirin.
- **Eksik izinler**, Botun hedef kanallarda okuma ve gönderme izinlerine ihtiyacı vardır.

---

## Model Sorunları

### Kimlik doğrulama hataları

- **Anahtar yapılandırılmamış**, Sağlayıcı API anahtarının ayarlandığından emin olun.
- **Anahtar süresi doldu**, Bazı OAuth token'ları sona erer. Yeniden kimlik doğrulayın.
- **Hız limiti**, Birden fazla anahtarınız varsa anahtar döndürme otomatik olarak geçer.

### Yavaş yanıtlar

- **Model seçimi**, Daha büyük modeller daha yavaştır. Hızlı görevler için daha hızlı bir model deneyin.
- **Bağlam boyutu**, Uzun konuşmalar işlemeyi yavaşlatır. `/compact` deneyin.
- **Ağ gecikmesi**, Model sağlayıcınıza bağlantıyı kontrol edin.

---

## Düğüm Sorunları

### Eşlik eden uygulama Gateway'i bulamıyor

- **Bağlama modu**, Gateway'in harici cihazlar için LAN veya Tailnet'e bağlı olması gerekir (geri döngü değil).
- **Aynı ağ**, Bonjour keşfi için her iki cihazın da aynı ağda olması gerekir.
- **Manuel giriş**, Uygulama ayarlarında Gateway ana bilgisayarını ve portunu manuel olarak girin.

---

## Oturum Sorunları

### Bağlam penceresi aşıldı

- **Sıkıştır**, Bağlamı özetlemek ve sıfırlamak için `/compact` kullanın.
- **Otomatik sıkıştırmayı etkinleştirin**, Yapılandırmada bir sıkıştırma eşiği ayarlayın.
- **Yeni oturum**, `/new` ile sıfırdan başlayın.

---

## Tanılama

Yerleşik tanılama aracı yaygın sorunları kontrol eder ve birçoğunu otomatik olarak düzeltebilir:

- Yapılandırma doğrulama
- Dosya izinleri
- Kanal bağlantısı
- Model kimlik doğrulama durumu
- Node.js uyumluluğu
- Ağ yapılandırması

Ayrıntılı hata bilgileri için Gateway günlüklerini kontrol edin. `/health` uç noktası, tüm bileşenlerin makine tarafından okunabilir durumunu sağlar.

---

## Yardım Almak

1. Otomatik düzeltmeler için tanılama aracını çalıştırın
2. Ayrıntılı hata mesajları için Gateway günlüklerini kontrol edin
3. Masaüstü uygulamasındaki Intercom sohbet widget'ı üzerinden destekle iletişime geçin