openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Eğer daha detaylı bir ilk inceleme yapmak isterseniz, OpenClaw'ın önerdiği tam teşhis zincirini de kullanabilirsiniz. Bu komutlar size 60 saniye içinde kapsamlı bir rapor sunar.

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Sağlıklı Bir Sistem Ne Söyler?

Bu komutların çıktılarında ne görmeniz gerektiğini bilirseniz, sorunu anında teşhis edebilirsiniz:

• openclaw gateway status komutu mutlaka Runtime: running ve Connectivity probe: ok mesajlarını vermelidir.
• openclaw channels status --probe komutunun çıktısında, kanalınızın taşıma bağlantısının kurulu (transport connected) olduğunu ve desteklenen yerlerde works veya audit ok gibi onayların bulunduğunu görmelisiniz.
• openclaw status raporunda belirgin bir kimlik doğrulama (auth error) veya yapılandırma hatası (config error) olmamalı.

Bir Güncellemeden Sonra mı Dondu?

Eğer sorun yeni bir güncellemeden sonra ortaya çıktıysa, büyük ihtimalle eklenti bağımlılıklarında veya yapılandırma yollarında bir bozulma vardır. OpenClaw'ın bu durum için resmi çözüm yolu bellidir: önce openclaw status --all ile tam raporu alın, ardından openclaw doctor --fix komutuyla onarımı başlatın ve son olarak openclaw gateway restart ile ağ geçidini yeniden başlatın. İşlem tamamlandıktan sonra openclaw status --all ile tekrar kontrol edin.

Eğer durum raporunda plugin load failed: dependency tree corrupted gibi bir hata görürseniz, bu tam olarak eklenti yapılandırma yolunun bozulduğuna işarettir ve openclaw doctor --fix bu sorunu çözmek için tasarlanmış ana komuttur.

Sorun Telegram Chatbot'unda mı? Özel Kontroller

Telegram, kendine has özellikleri nedeniyle ayrı bir ilgi ister. Eğer chatbot'unuz Telegram'da donduysa, şu belirtilere ve çözümlere odaklanın:

• Bot çevrimiçi ama yanıt vermiyor: Bu durumda öncelikle openclaw pairing list telegram komutuyla eşleşme durumunu kontrol edin.
• Grupta sessizlik hakim: Bot grupta çevrimiçi görünüyor ama hiçbir mesaja yanıt vermiyorsa, botun grup içindeki gizlilik modu (privacy mode) ayarlarını ve bahsetme zorunluluğu (mention gating) olup olmadığını kontrol edin. Botu etiketlemeden (@bot_adı) mesajlarınızı görmüyor olabilir.
• Ağ hataları: Log kayıtlarında Telegram API'sine (Telegram programlama arayüzü) yönelik ağ hataları (network error) görüyorsanız, DNS, IPv6 ayarlarınızı veya bir proxy kullanıyorsanız proxy yönlendirmenizi kontrol edin.
• Token geçersizliği (401 Hatası): Başlangıçta getMe returned 401 hatası alıyorsanız, bu bot jetonunuzun (token) geçersiz olduğu anlamına gelir. Telegram'daki BotFather üzerinden yeni bir jeton alıp yapılandırma dosyanızdaki botToken, tokenFile veya TELEGRAM_BOT_TOKEN değişkenine işlemeniz gerekir.
• Yoklama takılması (Polling Stall): Eğer bot periyodik olarak donup kendine geliyorsa, bu bir yoklama (polling) takılması veya yeniden bağlanmada yavaşlık olabilir. openclaw logs --follow ile anlık logları izleyin. Sorun devam ederse, kaynak genellikle proxy, DNS veya IPv6 ayarlarıdır.

Ağ Geçidi (Gateway) Mi Suçlu?

Bazen sorun botta değil, tüm sistemi yöneten ağ geçidindedir.

• openclaw komutu sistemdeki eski bir sürüme işaret ediyor veya yanlış çalıştırılıyor olabilir. Bunun için sistem PATH değişkeninizi kontrol edip yeni kurulumun yolunu gösterecek şekilde düzeltin.
• Eğer ağ geçidi servisi (gateway service) yanlış bir sürümle veya eski bir paketle kurulmuşsa, OpenClaw'ın resmi önerisi, servisi yeniden kurmak (reinstall) ve eski paket artıklarını temizlemektir.

Belirtiye Göre Hızlı Teşhis Tablosu

Hangi yolu izleyeceğinizden emin değilseniz, şu hızlı tablo size rehberlik edebilir:

• Gateway başlamıyor / probe başarısız: Sorun gateway, servis veya PATH ayarlarındadır. İlgili bölüme gidin.
• Gateway çalışıyor ama chatbot yanıt vermiyor: Sorun kanal akışı, eşleşme, bahsetme zorunluluğu, gizlilik modu, bot jetonu veya Telegram API'sine ağ bağlantısındadır. Telegram kontrollerine bakın.
• Donma bir güncellemeden sonra başladı: Önceliği doctor --fix komutuna ve gateway'i yeniden başlatmaya verin.
• Loglarda tekrar eden kritik hatalar var: Bu durum geçici bir takılma değil, genellikle kalıcı bir yapılandırma veya eklenti hatasıdır.

Sonuç

OpenClaw gibi modüler bir sistemde "durdu" demek, sorunun nerede olduğunu söylemez. Tahmin yürütmek yerine, buradaki sıralı teşhis adımlarını uygulayın. Önce beş temel komutu (status, gateway status, logs, doctor, channels probe) çalıştırın; elde ettiğiniz çıktılar, sorunun yukarıda belirtilen Telegram veya Gateway kaynaklı dallardan hangisinde olduğunu neredeyse kesin olarak gösterecektir. Bu çıktıları bir destek kanalında paylaşmanız gerekirse, özellikle openclaw gateway status, openclaw channels status --probe ve openclaw logs --follow komutlarının ilk 20-30 satırı, bir uzmanın sorununuzu anında teşhis etmesi için yeterli veriyi sağlayacaktır.

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Eğer daha detaylı bir ilk inceleme yapmak isterseniz, OpenClaw'ın önerdiği tam teşhis zincirini de kullanabilirsiniz. Bu komutlar size 60 saniye içinde kapsamlı bir rapor sunar.

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Sağlıklı Bir Sistem Ne Söyler?

Bu komutların çıktılarında ne görmeniz gerektiğini bilirseniz, sorunu anında teşhis edebilirsiniz:

• openclaw gateway status komutu mutlaka Runtime: running ve Connectivity probe: ok mesajlarını vermelidir.
• openclaw channels status --probe komutunun çıktısında, kanalınızın taşıma bağlantısının kurulu (transport connected) olduğunu ve desteklenen yerlerde works veya audit ok gibi onayların bulunduğunu görmelisiniz.
• openclaw status raporunda belirgin bir kimlik doğrulama (auth error) veya yapılandırma hatası (config error) olmamalı.

Bir Güncellemeden Sonra mı Dondu?

Eğer sorun yeni bir güncellemeden sonra ortaya çıktıysa, büyük ihtimalle eklenti bağımlılıklarında veya yapılandırma yollarında bir bozulma vardır. OpenClaw'ın bu durum için resmi çözüm yolu bellidir: önce openclaw status --all ile tam raporu alın, ardından openclaw doctor --fix komutuyla onarımı başlatın ve son olarak openclaw gateway restart ile ağ geçidini yeniden başlatın. İşlem tamamlandıktan sonra openclaw status --all ile tekrar kontrol edin.

Eğer durum raporunda plugin load failed: dependency tree corrupted gibi bir hata görürseniz, bu tam olarak eklenti yapılandırma yolunun bozulduğuna işarettir ve openclaw doctor --fix bu sorunu çözmek için tasarlanmış ana komuttur.

Sorun Telegram Chatbot'unda mı? Özel Kontroller

Telegram, kendine has özellikleri nedeniyle ayrı bir ilgi ister. Eğer chatbot'unuz Telegram'da donduysa, şu belirtilere ve çözümlere odaklanın:

• Bot çevrimiçi ama yanıt vermiyor: Bu durumda öncelikle openclaw pairing list telegram komutuyla eşleşme durumunu kontrol edin.
• Grupta sessizlik hakim: Bot grupta çevrimiçi görünüyor ama hiçbir mesaja yanıt vermiyorsa, botun grup içindeki gizlilik modu (privacy mode) ayarlarını ve bahsetme zorunluluğu (mention gating) olup olmadığını kontrol edin. Botu etiketlemeden (@bot_adı) mesajlarınızı görmüyor olabilir.
• Ağ hataları: Log kayıtlarında Telegram API'sine (Telegram programlama arayüzü) yönelik ağ hataları (network error) görüyorsanız, DNS, IPv6 ayarlarınızı veya bir proxy kullanıyorsanız proxy yönlendirmenizi kontrol edin.
• Token geçersizliği (401 Hatası): Başlangıçta getMe returned 401 hatası alıyorsanız, bu bot jetonunuzun (token) geçersiz olduğu anlamına gelir. Telegram'daki BotFather üzerinden yeni bir jeton alıp yapılandırma dosyanızdaki botToken, tokenFile veya TELEGRAM_BOT_TOKEN değişkenine işlemeniz gerekir.
• Yoklama takılması (Polling Stall): Eğer bot periyodik olarak donup kendine geliyorsa, bu bir yoklama (polling) takılması veya yeniden bağlanmada yavaşlık olabilir. openclaw logs --follow ile anlık logları izleyin. Sorun devam ederse, kaynak genellikle proxy, DNS veya IPv6 ayarlarıdır.

Ağ Geçidi (Gateway) Mi Suçlu?

Bazen sorun botta değil, tüm sistemi yöneten ağ geçidindedir.

• openclaw komutu sistemdeki eski bir sürüme işaret ediyor veya yanlış çalıştırılıyor olabilir. Bunun için sistem PATH değişkeninizi kontrol edip yeni kurulumun yolunu gösterecek şekilde düzeltin.
• Eğer ağ geçidi servisi (gateway service) yanlış bir sürümle veya eski bir paketle kurulmuşsa, OpenClaw'ın resmi önerisi, servisi yeniden kurmak (reinstall) ve eski paket artıklarını temizlemektir.

Belirtiye Göre Hızlı Teşhis Tablosu

Hangi yolu izleyeceğinizden emin değilseniz, şu hızlı tablo size rehberlik edebilir:

• Gateway başlamıyor / probe başarısız: Sorun gateway, servis veya PATH ayarlarındadır. İlgili bölüme gidin.
• Gateway çalışıyor ama chatbot yanıt vermiyor: Sorun kanal akışı, eşleşme, bahsetme zorunluluğu, gizlilik modu, bot jetonu veya Telegram API'sine ağ bağlantısındadır. Telegram kontrollerine bakın.
• Donma bir güncellemeden sonra başladı: Önceliği doctor --fix komutuna ve gateway'i yeniden başlatmaya verin.
• Loglarda tekrar eden kritik hatalar var: Bu durum geçici bir takılma değil, genellikle kalıcı bir yapılandırma veya eklenti hatasıdır.

Sonuç

OpenClaw gibi modüler bir sistemde "durdu" demek, sorunun nerede olduğunu söylemez. Tahmin yürütmek yerine, buradaki sıralı teşhis adımlarını uygulayın. Önce beş temel komutu (status, gateway status, logs, doctor, channels probe) çalıştırın; elde ettiğiniz çıktılar, sorunun yukarıda belirtilen Telegram veya Gateway kaynaklı dallardan hangisinde olduğunu neredeyse kesin olarak gösterecektir. Bu çıktıları bir destek kanalında paylaşmanız gerekirse, özellikle openclaw gateway status, openclaw channels status --probe ve openclaw logs --follow komutlarının ilk 20-30 satırı, bir uzmanın sorununuzu anında teşhis etmesi için yeterli veriyi sağlayacaktır.