OpenClaw botchat neden çalışmıyor? Sorunu kendi başınıza nasıl çözersiniz

Henüz elinizdeki kısıtlı belirtilerle “arızanın sebebi tam olarak X” demek mümkün değil. Ama yanlış giden bir şeyler olduğu kesin ve doğru teşhis yolu çok net. OpenClaw'ın kendi dokümantasyonu, tıpkı bir doktorun muayene sırası gibi, çalıştırmanız gereken beş kritik komutu baştan sona tanımlamış durumda. Bu sıralamaya sadık kalın .

İlk yapmanız gerekenler: Beş aşamalı kontrol listesi

Her şeyden önce terminali açın ve şu komutları sırasıyla çalıştırın:

1. openclaw status

2. openclaw gateway status

3. openclaw logs --follow

4. openclaw doctor

5. openclaw channels status --probe

Sağlıklı bir OpenClaw'dan almanız gereken temel çıktı şöyle görünmelidir:

Runtime: running

Connectivity probe: ok

Capability: read-only

audit ok

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

• 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

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

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.