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