Sorun giderme

Bu sayfa ayrıntılı çalıştırma kılavuzudur. Önce hızlı triyaj akışını istiyorsanız /help/troubleshooting ile başlayın.

Komut basamağı

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

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Beklenen sağlıklı sinyaller:

• openclaw gateway status, Runtime: running, Connectivity probe: ok ve bir Capability: ... satırı gösterir.
• openclaw doctor, engelleyici yapılandırma/hizmet sorunu bildirmez.
• openclaw channels status --probe, canlı hesap bazında aktarım durumunu ve desteklendiği yerde works veya audit ok gibi prob/denetim sonuçlarını gösterir.

Güncellemeden sonra

Bunu, güncelleme tamamlandığında ancak Gateway kapalı olduğunda, kanallar boş olduğunda veya model çağrıları 401'lerle başarısız olmaya başladığında kullanın.

openclaw status --allopenclaw update status --jsonopenclaw gateway status --deepopenclaw doctor --fixopenclaw gateway restart

Şunlara bakın:

• openclaw status / openclaw status --all içinde Update restart. Bekleyen veya başarısız devirler, çalıştırılacak sonraki komutu içerir.
• Channels altında plugin load failed: dependency tree corrupted; run openclaw doctor --fix. Bu, kanal yapılandırmasının hâlâ var olduğu, ancak Plugin kaydının kanal yüklenmeden önce başarısız olduğu anlamına gelir.
• yeniden kimlik doğrulamadan sonra sağlayıcı 401'leri. openclaw doctor --fix, eski ajan başına OAuth kimlik doğrulama gölgelerini denetler ve eski kopyaları kaldırır; böylece tüm ajanlar geçerli paylaşılan profili çözer.

Bölünmüş kurulumlar ve daha yeni yapılandırma koruması

Bunu, bir Gateway hizmeti bir güncellemeden sonra beklenmedik şekilde durduğunda veya günlükler bir openclaw ikilisinin openclaw.json dosyasını son yazan sürümden daha eski olduğunu gösterdiğinde kullanın.

OpenClaw, yapılandırma yazmalarını meta.lastTouchedVersion ile damgalar. Salt okunur komutlar, daha yeni bir OpenClaw tarafından yazılmış yapılandırmayı yine de inceleyebilir, ancak işlem ve hizmet mutasyonları daha eski bir ikiliden devam etmeyi reddeder. Engellenen eylemler arasında gateway hizmetini başlatma, durdurma, yeniden başlatma, kaldırma, zorunlu hizmet yeniden kurulumu, hizmet modunda gateway başlatma ve gateway --force port temizleme yer alır.

which openclawopenclaw --versionopenclaw gateway status --deepopenclaw config get meta.lastTouchedVersion

openclaw gateway install --forceopenclaw gateway restart

Geri alma sonrası protokol uyuşmazlığı

Bunu, OpenClaw sürümünü düşürdükten veya geri aldıktan sonra günlükler protocol mismatch yazdırmaya devam ettiğinde kullanın. Bu, daha eski bir Gateway çalıştığı, ancak daha yeni bir yerel istemci işleminin hâlâ daha eski Gateway'in konuşamadığı bir protokol aralığıyla yeniden bağlanmaya çalıştığı anlamına gelir.

openclaw --versionwhich -a openclawopenclaw gateway status --deepopenclaw doctor --deepopenclaw logs --follow

Şunlara bakın:

• Gateway günlüklerinde protocol mismatch ... client=... v<version> min=<n> max=<n> expected=<n>.
• openclaw gateway status --deep içinde Established clients: veya openclaw doctor --deep içinde Gateway clients. Bu, işletim sistemi izin verdiğinde PID'ler ve komut satırları dahil olmak üzere Gateway portuna bağlı etkin TCP istemcilerini listeler.
• Komut satırı geri aldığınız daha yeni OpenClaw kurulumunu veya sarmalayıcısını işaret eden bir istemci işlemi.

Düzeltme:

1. gateway status --deep tarafından gösterilen eski OpenClaw istemci işlemini durdurun veya yeniden başlatın.
2. Yerel panolar, düzenleyiciler, uygulama sunucusu yardımcıları veya uzun süre çalışan openclaw logs --follow kabukları gibi OpenClaw'ı gömen uygulamaları veya sarmalayıcıları yeniden başlatın.
3. openclaw gateway status --deep veya openclaw doctor --deep komutunu yeniden çalıştırın ve eski istemci PID'sinin gittiğini doğrulayın.

Daha eski bir Gateway'in daha yeni uyumsuz bir protokolü kabul etmesini sağlamayın. Protokol artışları kablo sözleşmesini korur; geri alma kurtarması bir işlem/sürüm temizleme sorunudur.

Skill sembolik bağlantısı yol kaçışı olarak atlandı

Günlükler şunu içerdiğinde bunu kullanın:

Skipping escaped skill path outside its configured root: ... reason=symlink-escape

OpenClaw her skill kökünü bir kapsama sınırı olarak ele alır. ~/.agents/skills, <workspace>/.agents/skills, <workspace>/skills veya ~/.openclaw/skills altındaki bir sembolik bağlantı, gerçek hedefi açıkça güvenilir olarak tanımlanmadıkça o kökün dışına çözümlendiğinde atlanır.

Bağlantıyı inceleyin:

ls -l ~/.agents/skills/<name>realpath ~/.agents/skills/<name>openclaw config get skills.load

Hedef kasıtlıysa hem doğrudan skill kökünü hem de izin verilen sembolik bağlantı hedefini yapılandırın:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Ardından yeni bir oturum başlatın veya skills izleyicisinin yenilenmesini bekleyin. Çalışan işlem yapılandırma değişikliğinden eskiyse gateway'i yeniden başlatın.

~, / veya tüm senkronize edilmiş proje klasörü gibi geniş hedefler kullanmayın. allowSymlinkTargets kapsamını, güvenilir SKILL.md dizinlerini içeren gerçek skill köküyle sınırlı tutun.

Skill Workshop apply'in bu güvenilir sembolik bağlantılı çalışma alanı skill yollarına da yazması gerekiyorsa skills.workshop.allowSymlinkTargetWrites ayarını etkinleştirin. Salt okunur paylaşılan skill kökleri için devre dışı bırakın.

İlgili:

• Skills yapılandırması
• Yapılandırma örnekleri

Anthropic 429 uzun bağlam için ek kullanım gerektiriyor

Günlükler/hatalar şunu içerdiğinde bunu kullanın: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

openclaw logs --followopenclaw models statusopenclaw config get agents.defaults.models

Şunlara bakın:

• Seçilen Anthropic modeli, GA özellikli 1M Claude 4.x modelidir veya modelde eski params.context1m: true vardır.
• Geçerli Anthropic kimlik bilgisi uzun bağlam kullanımı için uygun değildir.
• İstekler yalnızca 1M bağlam yoluna ihtiyaç duyan uzun oturumlarda/model çalıştırmalarında başarısız olur.

Düzeltme seçenekleri:

İlgili:

• Anthropic
• Token kullanımı ve maliyetler
• Anthropic'ten neden HTTP 429 görüyorum?

Yukarı akış 403 engellenmiş yanıtları

Bunu, yukarı akış LLM sağlayıcısı Your request was blocked gibi genel bir 403 döndürdüğünde kullanın.

Bunun her zaman bir OpenClaw yapılandırma sorunu olduğunu varsaymayın. Yanıt, OpenAI uyumlu bir uç noktanın önündeki CDN, WAF, bot yönetimi kuralı veya ters proxy gibi bir yukarı akış güvenlik katmanından gelebilir.

openclaw statusopenclaw gateway statusopenclaw logs --follow

Şunlara bakın:

• aynı sağlayıcı altındaki birden fazla modelin aynı şekilde başarısız olması
• normal sağlayıcı API hatası yerine HTML veya genel güvenlik metni
• aynı istek zamanı için sağlayıcı tarafı güvenlik olayları
• normal SDK biçimli istekler başarısız olurken küçük bir doğrudan curl probunun başarılı olması

Kanıt bir WAF/CDN engeline işaret ettiğinde önce sağlayıcı tarafı filtrelemeyi düzeltin. OpenClaw'ın kullandığı API yolu için dar kapsamlı bir izin veya atlama kuralını tercih edin ve tüm site için korumayı devre dışı bırakmaktan kaçının.

İlgili:

• OpenAI uyumlu uç noktalar
• Sağlayıcı yapılandırması
• Günlükler

Yerel OpenAI uyumlu arka uç doğrudan probları geçiyor ancak ajan çalıştırmaları başarısız oluyor

Bunu şu durumlarda kullanın:

• curl ... /v1/models çalışır
• küçük doğrudan /v1/chat/completions çağrıları çalışır
• OpenClaw model çalıştırmaları yalnızca normal ajan turlarında başarısız olur

curl http://127.0.0.1:1234/v1/modelscurl http://127.0.0.1:1234/v1/chat/completions \  -H 'content-type: application/json' \  -d '{"model":"<id>","messages":[{"role":"user","content":"hi"}],"stream":false}'openclaw infer model run --model <provider/model> --prompt "hi" --jsonopenclaw logs --follow

Şunlara bakın:

• doğrudan küçük çağrılar başarılı olur, ancak OpenClaw çalıştırmaları yalnızca daha büyük promptlarda başarısız olur
• doğrudan /v1/chat/completions aynı çıplak model kimliğiyle çalışsa bile model_not_found veya 404 hataları
• messages[].content için dize beklediğini belirten arka uç hataları
• OpenAI uyumlu yerel arka uçla aralıklı incomplete turn detected ... stopReason=stop payloads=0 uyarıları
• yalnızca daha büyük prompt-token sayıları veya tam ajan çalışma zamanı promptlarında görünen arka uç çökmeleri

İlgili:

• Yapılandırma
• Yerel modeller
• OpenAI uyumlu uç noktalar

Yanıt yok

Kanallar çalışıyor ancak hiçbir şey yanıt vermiyorsa, herhangi bir şeyi yeniden bağlamadan önce yönlendirmeyi ve politikayı kontrol edin.

openclaw statusopenclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw config get channelsopenclaw logs --follow

Şunlara bakın:

• DM gönderenleri için eşleştirme beklemede.
• Grup bahsi kapısı (requireMention, mentionPatterns).
• Kanal/grup izin listesi uyumsuzlukları.

Yaygın imzalar:

• drop guild message (mention required → grup mesajı bahsedilene kadar yok sayıldı.
• pairing request → gönderenin onaya ihtiyacı var.
• blocked / allowlist → gönderen/kanal politika tarafından filtrelendi.

İlgili:

• Kanal sorun giderme
• Gruplar
• Eşleştirme

Pano kontrol UI bağlantısı

Pano/kontrol UI bağlanmıyorsa URL'yi, kimlik doğrulama modunu ve güvenli bağlam varsayımlarını doğrulayın.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --json

Şunlara bakın:

• Doğru yoklama URL'si ve pano URL'si.
• İstemci ile gateway arasında kimlik doğrulama modu/token uyumsuzluğu.
• Cihaz kimliği gerektiği halde HTTP kullanımı.

Bir güncellemeden sonra yerel tarayıcı 127.0.0.1:18789 adresine bağlanamıyorsa, önce yerel Gateway hizmetini kurtarın ve panoyu sunduğunu doğrulayın:

openclaw gateway restartlsof -i :18789curl http://127.0.0.1:18789

curl OpenClaw HTML döndürürse Gateway çalışıyordur ve kalan sorun büyük olasılıkla tarayıcı önbelleği, eski bir derin bağlantı veya bayat sekme durumudur. http://127.0.0.1:18789 adresini doğrudan açın ve panodan ilerleyin. Yeniden başlatma hizmeti çalışır durumda bırakmıyorsa openclaw gateway start çalıştırın ve openclaw gateway status durumunu yeniden kontrol edin.

Kimlik doğrulama ayrıntı kodları hızlı haritası

Sonraki eylemi seçmek için başarısız connect yanıtındaki error.details.code değerini kullanın:

Cihaz kimlik doğrulama v2 migration kontrolü:

openclaw --versionopenclaw doctoropenclaw gateway status

Günlükler nonce/imza hataları gösteriyorsa bağlanan istemciyi güncelleyin ve doğrulayın:

openclaw devices rotate / revoke / remove beklenmedik şekilde reddedilirse:

• eşleştirilmiş cihaz token oturumları, çağıranda ayrıca operator.admin yoksa yalnızca kendi cihazlarını yönetebilir
• openclaw devices rotate --scope ... yalnızca çağıran oturumun zaten sahip olduğu operatör kapsamlarını isteyebilir

İlgili:

• Yapılandırma (gateway kimlik doğrulama modları)
• Control UI
• Cihazlar
• Uzaktan erişim
• Güvenilir proxy kimlik doğrulaması

Gateway hizmeti çalışmıyor

Hizmet yüklü ancak süreç ayakta kalmıyorsa bunu kullanın.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --deep   # sistem düzeyindeki hizmetleri de tara

Şunlara bakın:

• Çıkış ipuçlarıyla birlikte Runtime: stopped.
• Hizmet yapılandırması uyumsuzluğu (Config (cli) ve Config (service)).
• Port/dinleyici çakışmaları.
• --deep kullanıldığında ek launchd/systemd/schtasks kurulumları.
• Other gateway-like services detected (best effort) temizleme ipuçları.

İlgili:

• Arka plan yürütme ve süreç aracı
• Yapılandırma
• Doctor

macOS gateway sessizce yanıt vermeyi durduruyor, ardından panoya dokunduğunuzda devam ediyor

macOS host üzerindeki kanallar (Telegram, WhatsApp vb.) dakikalardan saatlere kadar sessiz kaldığında ve Control UI'yi açtığınız, SSH ile bağlandığınız veya host ile başka şekilde etkileşime geçtiğiniz anda gateway geri gelmiş göründüğünde bunu kullanın. Genellikle openclaw status içinde belirgin bir belirti olmaz, çünkü baktığınız zamana kadar gateway yeniden canlıdır.

ls ~/.openclaw/logs/stability/ | tail -5openclaw gateway stability --bundle latestpmset -g log | grep -iE "sleep|wake|maintenance" | tail -50launchctl print gui/$UID/ai.openclaw.gateway | grep -E "state|last exit|runs"

Şunları arayın:

• ~/.openclaw/logs/stability/ içinde error.code değeri ENETDOWN, ENETUNREACH, EHOSTUNREACH veya ECONNREFUSED gibi geçici bir ağ koduna ayarlanmış bir veya daha fazla *-uncaught_exception.json paketi.
• Çökme zaman damgalarıyla hizalanmış Entering Sleep state due to 'Maintenance Sleep' veya en0 driver is slow (msg: WillChangeState to 0) gibi pmset -g log satırları. Power Nap / Maintenance Sleep, Wi-Fi sürücüsünü kısa süreliğine 0 durumuna alır; bu pencereye denk gelen herhangi bir giden connect(), aksi halde tam ağ bağlantısına sahip bir konakta bile ENETDOWN ile başarısız olabilir.
• Özellikle çökme ile sonraki başlatma arasındaki boşluk saniyeler yerine yaklaşık bir saat olduğunda, bir çıkış kodu ve birden çok yakın tarihli runs ile state = not running gösteren launchctl print çıktısı. macOS launchd, çökme patlamasından sonra belgelendirilmemiş bir yeniden başlatma koruma kapısı uygular; bu kapı, etkileşimli oturum açma, pano bağlantısı veya launchctl kickstart gibi harici bir tetikleyici onu yeniden etkinleştirene kadar KeepAlive=true ayarını dikkate almayı durdurabilir.

Yaygın belirtiler:

• error.code değeri ENETDOWN veya kardeş bir kod olan ve çağrı yığını Node net lookupAndConnect / Socket.connect içine işaret eden bir kararlılık paketi. OpenClaw 2026.5.26 ve daha yeni sürümler bunları zararsız geçici ağ hataları olarak sınıflandırır, bu nedenle artık üst düzey yakalanmamış işleyiciye yayılmazlar; daha eski bir sürümdeyseniz önce yükseltin.
• Control UI'ye bağlandığınız veya konağa SSH ile girdiğiniz anda biten uzun sessiz dönemler: launchd yeniden başlatma kapısını yeniden etkinleştiren şey, panonun Gateway'e yaptığı herhangi bir işlem değil, kullanıcı tarafından görülebilen etkinliktir.
• ~/Library/Logs/openclaw/gateway.log içinde karşılık gelen received SIG*; shutting down satırı olmadan gün boyunca artan runs sayısı: temiz kapanışlar bir sinyal günlüğe kaydeder; geçici çökmeler kaydetmez.

Ne yapmalı:

1. 2026.5.26 öncesi bir sürüm çalıştırıyorsanız Gateway'i yükseltin. Yükseltmeden sonra gelecekteki ENETDOWN hataları süreci sonlandırmak yerine uyarı olarak günlüğe kaydedilir.

2. Her zaman açık sunucular olarak çalışması amaçlanan Mac mini / masaüstü konaklarda bakım uykusu etkinliğini azaltın:

   sudo pmset -a sleep 0 disksleep 0 standby 0 powernap 0

   Bu, altta yatan sürücü dalgalanmasını önemli ölçüde azaltır, ancak tamamen ortadan kaldırmaz. Sistem, bu bayraklardan bağımsız olarak TCP keepalive ve mDNS bakımı için yine de bazı bakım uykuları gerçekleştirebilir.

3. launchd tarafından beklemeye alınan gelecekteki bir çökme patlamasının hızla yakalanması için bir canlılık watchdog'u ekleyin:

   # Example launchd-aware liveness check, suitable for a 5-minute cron or LaunchAgentstate=$(launchctl print gui/$UID/ai.openclaw.gateway 2>/dev/null | awk -F'= ' '/state =/ {print $2; exit}')if [ "$state" != "running" ]; then  launchctl kickstart -k gui/$UID/ai.openclaw.gatewayfi

   Amaç, yeniden başlatma kapısını harici olarak yeniden etkinleştirmektir; macOS'ta bir çökme patlamasından sonra yalnızca KeepAlive=true yeterli değildir.

İlgili:

• macOS platform notları
• Günlükleme
• Doctor

Yüksek bellek kullanımı sırasında Gateway çıkıyor

Bunu, Gateway yük altında kaybolduğunda, supervisor OOM tarzı bir yeniden başlatma bildirdiğinde veya günlüklerde critical memory pressure bundle written ifadesi geçtiğinde kullanın.

openclaw gateway status --deepopenclaw logs --followopenclaw gateway stability --bundle latestopenclaw gateway diagnostics export

Şunları arayın:

• En son kararlılık paketinde Reason: diagnostic.memory.pressure.critical.
• critical/rss_threshold, critical/heap_threshold veya critical/rss_growth ile Memory pressure:.
• Heap sınırına yakın V8 heap: değerleri.
• agents/<agent>/sessions/<session>.jsonl veya sessions/<session>.jsonl gibi Largest session files: girdileri.
• Gateway bir container veya bellekle sınırlı hizmet içinde çalıştığında Linux cgroup bellek sayaçları.

Yaygın belirtiler:

• critical memory pressure bundle written yeniden başlatmadan kısa süre önce görünür → OpenClaw, OOM öncesi bir kararlılık paketi yakaladı. openclaw gateway stability --bundle latest ile inceleyin.
• Gateway günlüklerinde memory pressure: level=critical ... memoryPressureSnapshot=disabled görünür → OpenClaw kritik bellek baskısı algıladı, ancak OOM öncesi kararlılık anlık görüntüsü kapalıdır.
• Largest session files: çok büyük bir düzeltilmiş transcript yolunu işaret eder → yeniden başlatmadan önce tutulan oturum geçmişini azaltın, oturum büyümesini inceleyin veya eski transcript'leri etkin depodan çıkarın.
• V8 heap: kullanılan baytları heap sınırına yakındır → prompt/oturum baskısını düşürün, eşzamanlı işi azaltın veya iş yükünün beklendiğini doğruladıktan sonra Node heap sınırını yükseltin.
• Memory pressure: critical/rss_growth → bellek tek bir örnekleme penceresinde hızla büyüdü. Büyük bir içe aktarma, kontrolden çıkan araç çıktısı, yinelenen yeniden denemeler veya kuyruğa alınmış agent işlerinden oluşan bir toplu iş için en son günlükleri kontrol edin.
• Günlüklerde kritik bellek baskısı görünür, ancak paket yoktur → varsayılan budur. Gelecekteki kritik bellek baskısı olaylarında OOM öncesi kararlılık paketini yakalamak için diagnostics.memoryPressureSnapshot: true ayarlayın.

Kararlılık paketi yük içermez. Mesaj metni, webhook gövdeleri, kimlik bilgileri, token'lar, çerezler veya ham oturum kimlikleri değil; operasyonel bellek kanıtı ve düzeltilmiş göreli dosya yolları içerir. Hata raporlarına ham günlükleri kopyalamak yerine tanılama dışa aktarımını ekleyin.

İlgili:

• Gateway sağlığı
• Tanılama dışa aktarma
• Oturumlar

Gateway geçersiz yapılandırmayı reddetti

Bunu, Gateway başlangıcı Invalid config ile başarısız olduğunda veya sıcak yeniden yükleme günlükleri geçersiz bir düzenlemeyi atladığını söylediğinde kullanın.

openclaw logs --followopenclaw config fileopenclaw config validateopenclaw doctor

Şunları arayın:

• Invalid config at ...
• config reload skipped (invalid config): ...
• Config write rejected: ...
• Etkin yapılandırmanın yanında zaman damgalı bir openclaw.json.rejected.* dosyası
• doctor --fix bozuk bir doğrudan düzenlemeyi onardıysa zaman damgalı bir openclaw.json.clobbered.* dosyası
• OpenClaw her yapılandırma yolu için en son 32 .clobbered.* dosyasını tutar ve daha eskileri döndürür

CONFIG="$(openclaw config file)"ls -lt "$CONFIG".clobbered.* "$CONFIG".rejected.* 2>/dev/null | headdiff -u "$CONFIG" "$(ls -t "$CONFIG".clobbered.* 2>/dev/null | head -n 1)"openclaw config validateopenclaw doctor

İlgili:

• Yapılandırma
• Yapılandırma: sıcak yeniden yükleme
• Yapılandırma: sıkı doğrulama
• Doctor

Gateway probe uyarıları

Bunu, openclaw gateway probe bir şeye ulaştığında, ancak yine de bir uyarı bloğu yazdırdığında kullanın.

openclaw gateway probeopenclaw gateway probe --jsonopenclaw gateway probe --ssh user@gateway-host

Şunları arayın:

• JSON çıktısında warnings[].code ve primaryTargetId.
• Uyarının SSH fallback, birden çok Gateway, eksik kapsamlar veya çözümlenmemiş auth ref'leri hakkında olup olmadığı.

Yaygın belirtiler:

• SSH tunnel failed to start; falling back to direct probes. → SSH kurulumu başarısız oldu, ancak komut yine de doğrudan yapılandırılmış/loopback hedefleri denedi.
• multiple reachable gateway identities detected → farklı Gateway'ler yanıt verdi veya OpenClaw ulaşılabilir hedeflerin aynı Gateway olduğunu kanıtlayamadı. Aynı Gateway'e giden bir SSH tüneli, proxy URL'si veya yapılandırılmış uzak URL, taşıma bağlantı noktaları farklı olsa bile birden çok taşımalı tek Gateway olarak değerlendirilir.
• Read-probe diagnostics are limited by gateway scopes (missing operator.read) → bağlantı çalıştı, ancak ayrıntı RPC kapsamla sınırlı; cihaz kimliğini eşleştirin veya operator.read içeren kimlik bilgilerini kullanın.
• Gateway accepted the WebSocket connection, but follow-up read diagnostics failed → bağlantı çalıştı, ancak tam tanılama RPC seti zaman aşımına uğradı veya başarısız oldu. Bunu, tanılamaları zayıflamış ulaşılabilir bir Gateway olarak değerlendirin; --json çıktısında connect.ok ve connect.rpcOk değerlerini karşılaştırın.
• Capability: pairing-pending veya gateway closed (1008): pairing required → Gateway yanıt verdi, ancak bu istemcinin normal operator erişiminden önce hâlâ eşleştirme/onaya ihtiyacı var.
• çözümlenmemiş gateway.auth.* / gateway.remote.* SecretRef uyarı metni → başarısız hedef için bu komut yolunda auth materyali kullanılamıyordu.

İlgili:

• Gateway
• Aynı konakta birden çok Gateway
• Uzak erişim

Kanal bağlı, mesajlar akmıyor

Kanal durumu bağlıysa ancak mesaj akışı durmuşsa, policy, izinler ve kanala özgü teslim kurallarına odaklanın.

openclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw status --deepopenclaw logs --followopenclaw config get channels

Şunları arayın:

• DM policy (pairing, allowlist, open, disabled).
• Grup allowlist'i ve bahsetme gereksinimleri.
• Eksik kanal API izinleri/kapsamları.

Yaygın belirtiler:

• mention required → mesaj grup bahsetme policy'si tarafından yok sayıldı.
• pairing / bekleyen onay izleri → gönderen onaylı değil.
• missing_scope, not_in_channel, Forbidden, 401/403 → kanal auth/izin sorunu.

İlgili:

• Kanal sorun giderme
• Discord
• Telegram
• WhatsApp

Cron ve Heartbeat teslimi

Cron veya Heartbeat çalışmadıysa ya da teslim etmediyse, önce zamanlayıcı durumunu, sonra teslim hedefini doğrulayın.

openclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw system heartbeat lastopenclaw logs --follow

Şunları arayın:

• Cron etkin ve sonraki uyanma mevcut.
• İş çalıştırma geçmişi durumu (ok, skipped, error).
• Heartbeat atlama nedenleri (quiet-hours, requests-in-flight, cron-in-progress, lanes-busy, alerts-disabled, empty-heartbeat-file, no-tasks-due).

İlgili:

• Heartbeat
• Zamanlanmış görevler
• Zamanlanmış görevler: sorun giderme

Node eşleştirilmiş, araç başarısız oluyor

Bir Node eşleştirilmiş ancak araçlar başarısız oluyorsa ön plan, izin ve onay durumunu yalıtın.

openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followopenclaw status

Şunları arayın:

• Beklenen yeteneklerle Node çevrim içi.
• Kamera/mikrofon/konum/ekran için işletim sistemi izinleri.
• Exec onayları ve izin listesi durumu.

Yaygın imzalar:

• NODE_BACKGROUND_UNAVAILABLE → Node uygulaması ön planda olmalıdır.
• *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → işletim sistemi izni eksik.
• SYSTEM_RUN_DENIED: approval required → exec onayı bekliyor.
• SYSTEM_RUN_DENIED: allowlist miss → komut izin listesi tarafından engellendi.

İlgili:

• Exec onayları
• Node sorun giderme
• Node'lar

Tarayıcı aracı başarısız oluyor

Gateway sağlıklı olsa bile tarayıcı aracı eylemleri başarısız olduğunda bunu kullanın.

openclaw browser statusopenclaw browser start --browser-profile openclawopenclaw browser profilesopenclaw logs --followopenclaw doctor

Şunları arayın:

• plugins.allow ayarlanmış mı ve browser içeriyor mu.
• Geçerli tarayıcı çalıştırılabilir dosya yolu.
• CDP profil erişilebilirliği.
• existing-session / user profilleri için yerel Chrome kullanılabilirliği.

İlgili:

• Tarayıcı (OpenClaw tarafından yönetilen)
• Tarayıcı sorun giderme

Yükselttiyseniz ve bir şey aniden bozulduysa

Yükseltme sonrası bozulmaların çoğu yapılandırma sapması veya artık uygulanan daha katı varsayılanlardan kaynaklanır.

openclaw gateway statusopenclaw config get gateway.modeopenclaw config get gateway.remote.urlopenclaw config get gateway.auth.mode

openclaw config get gateway.bindopenclaw config get gateway.auth.modeopenclaw config get gateway.auth.tokenopenclaw gateway statusopenclaw logs --follow

openclaw devices listopenclaw pairing list --channel <channel> [--account <id>]openclaw logs --followopenclaw doctor

Kontrollerden sonra hizmet yapılandırması ve çalışma zamanı hâlâ uyuşmuyorsa hizmet meta verilerini aynı profil/durum dizininden yeniden kurun:

openclaw gateway install --forceopenclaw gateway restart

İlgili:

• Kimlik doğrulama
• Arka plan exec ve işlem aracı
• Gateway'e ait eşleştirme

İlgili

• Doctor
• SSS
• Gateway çalışma kitabı