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:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeSağlıklı temel durum:
Runtime: runningConnectivity probe: okCapability: read-only,write-capableveyaadmin-capable- Kanal probu taşımanın bağlı olduğunu ve desteklenen yerlerde
worksveyaaudit okgö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 --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --allopenclaw 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 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