Ana içeriğe atla
Bir kanal bağlandığı halde davranış yanlış olduğunda bu sayfayı kullanın.

Komut merdiveni

Önce bunları sırayla çalıştırın:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Sağlıklı temel durum:
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable veya admin-capable
  • Kanal probu taşımanın bağlı olduğunu ve desteklenen yerlerde works veya audit ok gösterir

Bir güncellemeden sonra

Telegram, iMessage, BlueBubbles dönemi yapılandırmaları veya başka bir Plugin kanalı güncellemeden sonra kaybolduğunda bunu kullanın.
openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all
openclaw status --all içinde plugin load failed: dependency tree corrupted; run openclaw doctor --fix arayın. Bu, kanalın yapılandırılmış olduğu, ancak Plugin kurulum/yükleme yolunun kanalı kaydetmek yerine bozuk bir bağımlılık ağacına takıldığı anlamına gelir. openclaw doctor --fix eski Plugin bağımlılık hazırlama dizinlerini ve eski kimlik doğrulama gölgelerini kaldırır, ardından openclaw gateway restart temiz durumu yeniden yükler.

WhatsApp

WhatsApp hata imzaları

BelirtiEn hızlı kontrolDüzeltme
Bağlı ama DM yanıtı yokopenclaw pairing list whatsappGöndereni onaylayın veya DM politikasını/izin listesini değiştirin.
Grup mesajları yok sayılıyorYapılandırmada requireMention + bahsetme desenlerini kontrol edinBottan bahsedin veya o grup için bahsetme politikasını gevşetin.
QR oturum açma 408 ile zaman aşımına uğruyorGateway HTTPS_PROXY / HTTP_PROXY env değerini kontrol edinErişilebilir bir proxy ayarlayın; NO_PROXY değerini yalnızca atlamalar için kullanın.
Rastgele bağlantı kopma/yeniden giriş döngüleriopenclaw channels status --probe + günlüklerYakın tarihli yeniden bağlantılar şu anda bağlı olsa bile işaretlenir; günlükleri izleyin, Gateway’i yeniden başlatın, dalgalanma sürerse yeniden bağlayın.
status=408 Request Time-out döngüsüProb, günlükler, doctor, ardından Gateway durumuÖnce ana makine bağlantısını/zamanlamasını düzeltin; döngü sürerse kimlik doğrulamayı yedekleyip hesabı yeniden bağlayın.
Yanıtlar saniyeler/dakikalar geç geliyoropenclaw doctor --fixDoctor, Gateway olay döngüsünü bozduğu doğrulanan eski yerel TUI istemcilerini durdurur.
Tam sorun giderme: WhatsApp sorun giderme

Telegram

Telegram hata imzaları

BelirtiEn hızlı kontrolDüzeltme
/start var ama kullanılabilir yanıt akışı yokopenclaw pairing list telegramEşleştirmeyi onaylayın veya DM politikasını değiştirin.
Bot çevrim içi ama grup sessiz kalıyorBahsetme gerekliliğini ve bot gizlilik modunu doğrulayınGrup görünürlüğü için gizlilik modunu devre dışı bırakın veya bottan bahsedin.
Ağ hatalarıyla gönderme başarısızlıklarıTelegram API çağrısı başarısızlıkları için günlükleri inceleyinapi.telegram.org için DNS/IPv6/proxy yönlendirmesini düzeltin.
Başlangıç getMe returned 401 bildiriyorYapılandırılmış token kaynağını kontrol edinBotFather token’ını yeniden kopyalayın veya yeniden oluşturun ve botToken, tokenFile ya da varsayılan hesap TELEGRAM_BOT_TOKEN değerini güncelleyin.
Yoklama takılıyor veya yavaş yeniden bağlanıyorYoklama tanılamaları için openclaw logs --followYükseltin; yeniden başlatmalar yanlış pozitifse pollingStallThresholdMs değerini ayarlayın. Kalıcı takılmalar yine proxy/DNS/IPv6 sorununa işaret eder.
setMyCommands başlangıçta reddedildiBOT_COMMANDS_TOO_MUCH için günlükleri inceleyinPlugin/skill/özel Telegram komutlarını azaltın veya yerel menüleri devre dışı bırakın.
Yükseltme sonrası izin listesi sizi engelliyoropenclaw security audit ve yapılandırma izin listeleriopenclaw doctor --fix çalıştırın veya @username yerine sayısal gönderen kimlikleri kullanın.
Tam sorun giderme: Telegram sorun giderme

Discord

Discord hata imzaları

BelirtiEn hızlı kontrolDüzeltme
Bot çevrim içi ama loncada yanıt yokopenclaw channels status --probeLonca/kanala izin verin ve mesaj içeriği amacını doğrulayın.
Grup mesajları yok sayılıyorBahsetme geçidi nedeniyle düşenler için günlükleri kontrol edinBottan bahsedin veya lonca/kanal requireMention: false ayarlayın.
Yazıyor/token kullanımı var ama Discord mesajı yokBunun ortam oda olayı mı yoksa modelin message(action=send) çağrısını kaçırdığı, katılım yapılmış bir message_tool odası mı olduğunu kontrol edinBastırılmış son yük meta verileri için Gateway ayrıntılı günlüğünü inceleyin, messages.groupChat.unmentionedInbound değerini doğrulayın, Ortam oda olayları sayfasını okuyun veya normal grup istekleri için messages.groupChat.visibleReplies: "automatic" tutun.
DM yanıtları eksikopenclaw pairing list discordDM eşleştirmesini onaylayın veya DM politikasını ayarlayın.
Tam sorun giderme: Discord sorun giderme

Slack

Slack hata imzaları

BelirtiEn hızlı kontrolDüzeltme
Socket mode bağlı ama yanıt yokopenclaw channels status --probeUygulama token’ını + bot token’ını ve gerekli kapsamları doğrulayın; SecretRef destekli kurulumlarda botTokenStatus / appTokenStatus = configured_unavailable değerlerini izleyin.
DM’ler engelleniyoropenclaw pairing list slackEşleştirmeyi onaylayın veya DM politikasını gevşetin.
Kanal mesajı yok sayılıyorgroupPolicy ve kanal izin listesini kontrol edinKanala izin verin veya politikayı open olarak değiştirin.
Tam sorun giderme: Slack sorun giderme

iMessage

iMessage hata imzaları

BelirtiEn hızlı kontrolDüzeltme
imsg eksik veya macOS olmayan sistemlerde başarısızopenclaw channels status --probe --channel imessageOpenClaw’ı Messages Mac üzerinde çalıştırın veya cliPath için bir SSH sarmalayıcısı kullanın.
macOS’te gönderebiliyor ama alamıyorMessages otomasyonu için macOS gizlilik izinlerini kontrol edinTCC izinlerini yeniden verin ve kanal sürecini yeniden başlatın.
DM göndereni engellenmişopenclaw pairing list imessageEşleştirmeyi onaylayın veya izin listesini güncelleyin.
Tam sorun giderme:

Signal

Signal hata imzaları

BelirtiEn hızlı kontrolDüzeltme
Daemon erişilebilir ama bot sessizopenclaw channels status --probesignal-cli daemon URL/hesabını ve alma modunu doğrulayın.
DM engellenmişopenclaw pairing list signalGöndereni onaylayın veya DM politikasını ayarlayın.
Grup yanıtları tetiklenmiyorGrup izin listesini ve bahsetme desenlerini kontrol edinGöndereni/grubu ekleyin veya geçidi gevşetin.
Tam sorun giderme: Signal sorun giderme

QQ Bot

QQ Bot hata imzaları

BelirtiEn hızlı kontrolDüzeltme
Bot “gone to Mars” yanıtı veriyorYapılandırmada appId ve clientSecret değerlerini doğrulayınKimlik bilgilerini ayarlayın veya Gateway’i yeniden başlatın.
Gelen mesaj yokopenclaw channels status --probeQQ Open Platform üzerinde kimlik bilgilerini doğrulayın.
Ses yazıya dökülmüyorSTT sağlayıcı yapılandırmasını kontrol edinchannels.qqbot.stt veya tools.media.audio yapılandırın.
Proaktif mesajlar ulaşmıyorQQ platform etkileşim gereksinimlerini kontrol edinQQ, yakın zamanda etkileşim olmadan bot tarafından başlatılan mesajları engelleyebilir.
Tam sorun giderme: QQ Bot sorun giderme

Matrix

Matrix hata belirtileri

BelirtiEn hızlı kontrolDüzeltme
Oturum açılmış ama oda iletilerini yok sayıyoropenclaw channels status --probegroupPolicy, oda izin listesi ve bahsetme kısıtlamasını kontrol edin.
DM’ler işlenmiyoropenclaw pairing list matrixGöndereni onaylayın veya DM politikasını ayarlayın.
Şifreli odalar başarısız oluyoropenclaw matrix verify statusCihazı yeniden doğrulayın, ardından openclaw matrix verify backup status komutunu kontrol edin.
Yedek geri yükleme beklemede/bozukopenclaw matrix verify backup statusopenclaw matrix verify backup restore komutunu çalıştırın veya kurtarma anahtarıyla yeniden çalıştırın.
Çapraz imzalama/önyükleme hatalı görünüyoropenclaw matrix verify bootstrapGizli depolamayı, çapraz imzalamayı ve yedek durumunu tek geçişte onarın.
Tam kurulum ve yapılandırma: Matrix

İlgili