Configuration

Kanal sorunlarını giderme

Bir kanal bağlandığı halde davranış yanlış olduğunda bu sayfayı kullanın.

Komut merdiveni

Önce bunları sırayla çalıştırın:

bash
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw 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.

bash
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw 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ı

Belirti En hızlı kontrol Düzeltme
Bağlı ama DM yanıtı yok openclaw pairing list whatsapp Göndereni onaylayın veya DM politikasını/izin listesini değiştirin.
Grup mesajları yok sayılıyor Yapılandırmada requireMention + bahsetme desenlerini kontrol edin Bottan bahsedin veya o grup için bahsetme politikasını gevşetin.
QR oturum açma 408 ile zaman aşımına uğruyor Gateway HTTPS_PROXY / HTTP_PROXY env değerini kontrol edin Erişilebilir bir proxy ayarlayın; NO_PROXY değerini yalnızca atlamalar için kullanın.
Rastgele bağlantı kopma/yeniden giriş döngüleri openclaw channels status --probe + günlükler Yakı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ç geliyor openclaw doctor --fix Doctor, 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ı

Belirti En hızlı kontrol Düzeltme
/start var ama kullanılabilir yanıt akışı yok openclaw pairing list telegram Eşleştirmeyi onaylayın veya DM politikasını değiştirin.
Bot çevrim içi ama grup sessiz kalıyor Bahsetme gerekliliğini ve bot gizlilik modunu doğrulayın Grup 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 inceleyin api.telegram.org için DNS/IPv6/proxy yönlendirmesini düzeltin.
Başlangıç getMe returned 401 bildiriyor Yapılandırılmış token kaynağını kontrol edin BotFather 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ıyor Yoklama tanılamaları için openclaw logs --follow Yü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 reddedildi BOT_COMMANDS_TOO_MUCH için günlükleri inceleyin Plugin/skill/özel Telegram komutlarını azaltın veya yerel menüleri devre dışı bırakın.
Yükseltme sonrası izin listesi sizi engelliyor openclaw security audit ve yapılandırma izin listeleri openclaw 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ı

Belirti En hızlı kontrol Düzeltme
Bot çevrim içi ama loncada yanıt yok openclaw channels status --probe Lonca/kanala izin verin ve mesaj içeriği amacını doğrulayın.
Grup mesajları yok sayılıyor Bahsetme geçidi nedeniyle düşenler için günlükleri kontrol edin Bottan bahsedin veya lonca/kanal requireMention: false ayarlayın.
Yazıyor/token kullanımı var ama Discord mesajı yok Bunun 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 edin Bastı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ı eksik openclaw pairing list discord DM eşleştirmesini onaylayın veya DM politikasını ayarlayın.

Tam sorun giderme: Discord sorun giderme

Slack

Slack hata imzaları

Belirti En hızlı kontrol Düzeltme
Socket mode bağlı ama yanıt yok openclaw channels status --probe Uygulama token'ını + bot token'ını ve gerekli kapsamları doğrulayın; SecretRef destekli kurulumlarda botTokenStatus / appTokenStatus = configured_unavailable değerlerini izleyin.
DM'ler engelleniyor openclaw pairing list slack Eşleştirmeyi onaylayın veya DM politikasını gevşetin.
Kanal mesajı yok sayılıyor groupPolicy ve kanal izin listesini kontrol edin Kanala izin verin veya politikayı open olarak değiştirin.

Tam sorun giderme: Slack sorun giderme

iMessage

iMessage hata imzaları

Belirti En hızlı kontrol Düzeltme
imsg eksik veya macOS olmayan sistemlerde başarısız openclaw channels status --probe --channel imessage OpenClaw'ı Messages Mac üzerinde çalıştırın veya cliPath için bir SSH sarmalayıcısı kullanın.
macOS'te gönderebiliyor ama alamıyor Messages otomasyonu için macOS gizlilik izinlerini kontrol edin TCC izinlerini yeniden verin ve kanal sürecini yeniden başlatın.
DM göndereni engellenmiş openclaw pairing list imessage Eşleştirmeyi onaylayın veya izin listesini güncelleyin.

Tam sorun giderme:

Signal

Signal hata imzaları

Belirti En hızlı kontrol Düzeltme
Daemon erişilebilir ama bot sessiz openclaw channels status --probe signal-cli daemon URL/hesabını ve alma modunu doğrulayın.
DM engellenmiş openclaw pairing list signal Göndereni onaylayın veya DM politikasını ayarlayın.
Grup yanıtları tetiklenmiyor Grup izin listesini ve bahsetme desenlerini kontrol edin Göndereni/grubu ekleyin veya geçidi gevşetin.

Tam sorun giderme: Signal sorun giderme

QQ Bot

QQ Bot hata imzaları

Belirti En hızlı kontrol Düzeltme
Bot "gone to Mars" yanıtı veriyor Yapılandırmada appId ve clientSecret değerlerini doğrulayın Kimlik bilgilerini ayarlayın veya Gateway'i yeniden başlatın.
Gelen mesaj yok openclaw channels status --probe QQ Open Platform üzerinde kimlik bilgilerini doğrulayın.
Ses yazıya dökülmüyor STT sağlayıcı yapılandırmasını kontrol edin channels.qqbot.stt veya tools.media.audio yapılandırın.
Proaktif mesajlar ulaşmıyor QQ platform etkileşim gereksinimlerini kontrol edin QQ, 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

Belirti En hızlı kontrol Düzeltme
Oturum açılmış ama oda iletilerini yok sayıyor openclaw channels status --probe groupPolicy, oda izin listesi ve bahsetme kısıtlamasını kontrol edin.
DM'ler işlenmiyor openclaw pairing list matrix Göndereni onaylayın veya DM politikasını ayarlayın.
Şifreli odalar başarısız oluyor openclaw matrix verify status Cihazı yeniden doğrulayın, ardından openclaw matrix verify backup status komutunu kontrol edin.
Yedek geri yükleme beklemede/bozuk openclaw matrix verify backup status openclaw 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üyor openclaw matrix verify bootstrap Gizli depolamayı, çapraz imzalamayı ve yedek durumunu tek geçişte onarın.

Tam kurulum ve yapılandırma: Matrix

İlgili

Was this useful?
On this page

On this page