Telegram'da en sık karşılaşılan dört kabus senaryosu

1. Bot çevrimiçi görünüyor ama grupta çıt çıkmıyor

Bu, en sinsi ve can sıkıcı Telegram sorunudur. Botunuzun profilinde “çevrimiçi” yazar, ancak gruba yazdığınız mesajları görmezden gelir. Resmi dokümanların işaret ettiği ilk nokta, botun gizlilik modu (privacy mode) ve bahsetme zorunluluğudur (requireMention). Telegram botları varsayılan olarak yalnızca kendilerine açıkça hitap edilen komutları ve bahsedildikleri (/botadi şeklinde) mesajları görür. Botun tüm grup mesajlarını okuyabilmesi için şunları yapmalısınız :

• BotFather üzerinden botunuzun gizlilik modunu devre dışı bırakın. Bunun için BotFather'a /setprivacy komutunu gönderip Disable seçeneğini seçin.
• Alternatif olarak, botunuzu grup yöneticisi (admin) yapın.
• İşin püf noktası: Ayarları değiştirdikten sonra botu gruptan çıkarıp tekrar eklemelisiniz. Telegram, gizlilik modundaki bir değişikliği ancak bu şekilde günceller.

2. Bot sürekli 401 hatası veriyor ve başlamıyor

Eğer günlük kayıtlarınızda (openclaw logs --follow) getMe returned 401 hatasını görüyorsanız, bu doğrudan bir kimlik doğrulama sorunudur. Kullandığınız bot token'ı geçersizdir ya da süresi dolmuştur. Çözüm adımları :

• BotFather'dan yeni bir token oluşturun.
• Bu yeni token'ı OpenClaw yapılandırmanızda botToken, tokenFile veya TELEGRAM_BOT_TOKEN çevresel değişkeninde güncelleyin (hangi yöntemi kullanıyorsanız).

3. Ağ hataları: Bot mesaj gönderemiyor veya sürekli kopuyor

Botunuz anlık olarak bağlanıp kopuyorsa veya mesaj gönderirken sürekli ağ hatası alıyorsanız, suçlu genellikle sizin sunucunuz ile Telegram'ın api.telegram.org adresi arasındaki yolda gizlidir. Dokümanlar, sık tekrarlayan kopmaların ve yavaşlamaların ardında genellikle DNS, IPv6 veya proxy yönlendirme sorunları olduğunu söylüyor . Yapmanız gerekenler:

• Sunucunuzda DNS ayarlarınızı kontrol edin. Bazı internet servis sağlayıcılarının DNS'leri Telegram API'leriyle sorun yaşayabilir.
• IPv6'nın düzgün çalıştığından emin olun veya sorunun kaynağı olduğundan şüpheleniyorsanız geçici olarak devre dışı bırakın.
• Eğer bir proxy sunucusu kullanıyorsanız, yönlendirmenin api.telegram.org için doğru ve kesintisiz olduğundan emin olun.

4. 409 çakışma hatası: Aynı token'ı iki yerde kullanıyorsunuz

Günlüklerde getUpdates 409 conflict hatası görmek, aynı bot token'ını kullanan başka bir OpenClaw ağ geçidi (gateway), bir script veya üçüncü parti bir uygulama olduğu anlamına gelir . OpenClaw'ın Telegram entegrasyonu, “uzun yoklama (long polling)” adı verilen bir yöntem kullanır ve sistem, her bot token'ı için yalnızca tek bir aktif yoklayıcı olmasını sağlamak üzere tasarlanmıştır. Bir çakışmayı çözmek için, aynı token'ı kullanan diğer tüm süreçleri belirleyip durdurun.

Bir güncellemeden sonra her şey bozulduysa

OpenClaw'ı güncelledikten sonra ortalık yangın yerine döndüyse, izlemeniz gereken adımlar şöyle :

1. openclaw status --all ile genel bir durum raporu alın.
2. openclaw doctor --fix komutunu çalıştırın. Bu komut, belki de suçlu olan eski ve bozuk eklenti bağımlılıklarını temizleyecektir.
3. openclaw gateway restart ile ağ geçidini yeniden başlatın.
4. Son olarak, her şeyin yolunda olduğundan emin olmak için tekrar openclaw status --all yazın.

Özellikle durum raporunda şu satırı görürseniz, işiniz sihirli bir komuta bakar: plugin load failed: dependency tree corrupted; run openclaw doctor --fix. Bu hata, kanalın yapılandırıldığı ancak eklentinin bozuk bir bağımlılık ağacı yüzünden yüklenemediğini söyler . Çözüm tam da belirtildiği gibidir: openclaw doctor --fix.

Telegram için doğru kurulum nasıl olmalı

Küçük ama hayati bir not: OpenClaw'da Telegram kanalını etkinleştirmek için openclaw channels login telegram gibi bir login komutu kullanmazsınız. Süreç tamamen şöyledir :

1. BotFather'dan aldığınız token'ı, OpenClaw'ın yapılandırma dosyasına veya ortam değişkenlerine tanımlarsınız.
2. Yapılandırmada channels.telegram.enabled: true olarak ayarlanır.
3. OpenClaw ağ geçidi başlatılır.

Botunuz, özel mesaj varsayılan olarak bir “eşleştirme (pairing)” onayı isteyebilir. İlk kez mesaj attığınızda size bir eşleştirme kodu dönebilir. Bunu onaylamak için terminalde şu komutu çalıştırmalısınız :

• Bekleyen eşleştirmeleri listeleyin: openclaw pairing list telegram
• Kodu onaylayın: openclaw pairing approve telegram <KODUNUZ>

Özetle

• Şu anki belirtilerle, “arızanın tek sebebi budur” demek için yeterli veri yok. Insufficient evidence.
• Ancak sorunu doğru şekilde çözmek için ilk adım, yukarıda başta verdiğimiz beş teşhis komutunun çıktısını almaktır. Sorun hangi aşamada başlıyorsa, çözüm de onun üzerine kuruludur.
• Özellikle Telegram kullanıcıları için en kritik dört kontrol noktası şunlardır: Gizlilik modu/bahsetme zorunluluğu, geçersiz bot token'ı (401), DNS/IPv6/proxy ağ sorunları ve aynı token için oluşan yoklama çakışması (409). Bu ağacı dallarıyla kontrol etmek, sorunun büyük ihtimalle kaynağını bulmanızı sağlayacaktır.

Telegram'da en sık karşılaşılan dört kabus senaryosu

1. Bot çevrimiçi görünüyor ama grupta çıt çıkmıyor

Bu, en sinsi ve can sıkıcı Telegram sorunudur. Botunuzun profilinde “çevrimiçi” yazar, ancak gruba yazdığınız mesajları görmezden gelir. Resmi dokümanların işaret ettiği ilk nokta, botun gizlilik modu (privacy mode) ve bahsetme zorunluluğudur (requireMention). Telegram botları varsayılan olarak yalnızca kendilerine açıkça hitap edilen komutları ve bahsedildikleri (/botadi şeklinde) mesajları görür. Botun tüm grup mesajlarını okuyabilmesi için şunları yapmalısınız :

• BotFather üzerinden botunuzun gizlilik modunu devre dışı bırakın. Bunun için BotFather'a /setprivacy komutunu gönderip Disable seçeneğini seçin.
• Alternatif olarak, botunuzu grup yöneticisi (admin) yapın.
• İşin püf noktası: Ayarları değiştirdikten sonra botu gruptan çıkarıp tekrar eklemelisiniz. Telegram, gizlilik modundaki bir değişikliği ancak bu şekilde günceller.

2. Bot sürekli 401 hatası veriyor ve başlamıyor

Eğer günlük kayıtlarınızda (openclaw logs --follow) getMe returned 401 hatasını görüyorsanız, bu doğrudan bir kimlik doğrulama sorunudur. Kullandığınız bot token'ı geçersizdir ya da süresi dolmuştur. Çözüm adımları :

• BotFather'dan yeni bir token oluşturun.
• Bu yeni token'ı OpenClaw yapılandırmanızda botToken, tokenFile veya TELEGRAM_BOT_TOKEN çevresel değişkeninde güncelleyin (hangi yöntemi kullanıyorsanız).

3. Ağ hataları: Bot mesaj gönderemiyor veya sürekli kopuyor

Botunuz anlık olarak bağlanıp kopuyorsa veya mesaj gönderirken sürekli ağ hatası alıyorsanız, suçlu genellikle sizin sunucunuz ile Telegram'ın api.telegram.org adresi arasındaki yolda gizlidir. Dokümanlar, sık tekrarlayan kopmaların ve yavaşlamaların ardında genellikle DNS, IPv6 veya proxy yönlendirme sorunları olduğunu söylüyor . Yapmanız gerekenler:

• Sunucunuzda DNS ayarlarınızı kontrol edin. Bazı internet servis sağlayıcılarının DNS'leri Telegram API'leriyle sorun yaşayabilir.
• IPv6'nın düzgün çalıştığından emin olun veya sorunun kaynağı olduğundan şüpheleniyorsanız geçici olarak devre dışı bırakın.
• Eğer bir proxy sunucusu kullanıyorsanız, yönlendirmenin api.telegram.org için doğru ve kesintisiz olduğundan emin olun.

4. 409 çakışma hatası: Aynı token'ı iki yerde kullanıyorsunuz

Günlüklerde getUpdates 409 conflict hatası görmek, aynı bot token'ını kullanan başka bir OpenClaw ağ geçidi (gateway), bir script veya üçüncü parti bir uygulama olduğu anlamına gelir . OpenClaw'ın Telegram entegrasyonu, “uzun yoklama (long polling)” adı verilen bir yöntem kullanır ve sistem, her bot token'ı için yalnızca tek bir aktif yoklayıcı olmasını sağlamak üzere tasarlanmıştır. Bir çakışmayı çözmek için, aynı token'ı kullanan diğer tüm süreçleri belirleyip durdurun.

Bir güncellemeden sonra her şey bozulduysa

OpenClaw'ı güncelledikten sonra ortalık yangın yerine döndüyse, izlemeniz gereken adımlar şöyle :

1. openclaw status --all ile genel bir durum raporu alın.
2. openclaw doctor --fix komutunu çalıştırın. Bu komut, belki de suçlu olan eski ve bozuk eklenti bağımlılıklarını temizleyecektir.
3. openclaw gateway restart ile ağ geçidini yeniden başlatın.
4. Son olarak, her şeyin yolunda olduğundan emin olmak için tekrar openclaw status --all yazın.

Özellikle durum raporunda şu satırı görürseniz, işiniz sihirli bir komuta bakar: plugin load failed: dependency tree corrupted; run openclaw doctor --fix. Bu hata, kanalın yapılandırıldığı ancak eklentinin bozuk bir bağımlılık ağacı yüzünden yüklenemediğini söyler . Çözüm tam da belirtildiği gibidir: openclaw doctor --fix.

Telegram için doğru kurulum nasıl olmalı

Küçük ama hayati bir not: OpenClaw'da Telegram kanalını etkinleştirmek için openclaw channels login telegram gibi bir login komutu kullanmazsınız. Süreç tamamen şöyledir :

1. BotFather'dan aldığınız token'ı, OpenClaw'ın yapılandırma dosyasına veya ortam değişkenlerine tanımlarsınız.
2. Yapılandırmada channels.telegram.enabled: true olarak ayarlanır.
3. OpenClaw ağ geçidi başlatılır.

Botunuz, özel mesaj varsayılan olarak bir “eşleştirme (pairing)” onayı isteyebilir. İlk kez mesaj attığınızda size bir eşleştirme kodu dönebilir. Bunu onaylamak için terminalde şu komutu çalıştırmalısınız :

• Bekleyen eşleştirmeleri listeleyin: openclaw pairing list telegram
• Kodu onaylayın: openclaw pairing approve telegram <KODUNUZ>

Özetle

• Şu anki belirtilerle, “arızanın tek sebebi budur” demek için yeterli veri yok. Insufficient evidence.
• Ancak sorunu doğru şekilde çözmek için ilk adım, yukarıda başta verdiğimiz beş teşhis komutunun çıktısını almaktır. Sorun hangi aşamada başlıyorsa, çözüm de onun üzerine kuruludur.
• Özellikle Telegram kullanıcıları için en kritik dört kontrol noktası şunlardır: Gizlilik modu/bahsetme zorunluluğu, geçersiz bot token'ı (401), DNS/IPv6/proxy ağ sorunları ve aynı token için oluşan yoklama çakışması (409). Bu ağacı dallarıyla kontrol etmek, sorunun büyük ihtimalle kaynağını bulmanızı sağlayacaktır.