Sorun giderme

• Yerel MLX/vLLM tarzı sunucuda model_not_found → baseUrl değerinin /v1 içerdiğini, /v1/chat/completions arka uçları için api değerinin "openai-completions" olduğunu ve models.providers.<provider>.models[].id değerinin yalın sağlayıcı-yerel kimlik olduğunu doğrulayın. Bunu sağlayıcı önekiyle bir kez seçin, örneğin mlx/mlx-community/Qwen3-30B-A3B-6bit; katalog girdisini mlx-community/Qwen3-30B-A3B-6bit olarak tutun.
• messages[...].content: invalid type: sequence, expected a string → arka uç yapılandırılmış Chat Completions içerik parçalarını reddediyor. Düzeltme: models.providers.<provider>.models[].compat.requiresStringContent: true ayarlayın.
• incomplete turn detected ... stopReason=stop payloads=0 → arka uç Chat Completions isteğini tamamladı ancak o dönüş için kullanıcıya görünür asistan metni döndürmedi. OpenClaw, yeniden oynatması güvenli boş OpenAI uyumlu dönüşleri bir kez yeniden dener; kalıcı hatalar genellikle arka ucun boş/metin olmayan içerik yaydığı veya son yanıt metnini bastırdığı anlamına gelir.
• doğrudan küçük istekler başarılı olur, ancak OpenClaw ajan çalıştırmaları arka uç/model çökmeleriyle başarısız olur (örneğin bazı inferrs derlemelerinde Gemma) → OpenClaw aktarımı muhtemelen zaten doğrudur; arka uç daha büyük ajan çalışma zamanı istem biçiminde başarısız oluyordur.
• araçlar devre dışı bırakıldıktan sonra hatalar azalır ancak kaybolmaz → araç şemaları baskının bir parçasıydı, ancak kalan sorun hâlâ yukarı akış model/sunucu kapasitesi veya bir arka uç hatasıdır.

1. Yalnızca dize kabul eden Chat Completions arka uçları için compat.requiresStringContent: true ayarlayın.
2. OpenClaw'ın araç şeması yüzeyini güvenilir şekilde işleyemeyen modeller/arka uçlar için compat.supportsTools: false ayarlayın.
3. Mümkün olduğunda istem baskısını azaltın: daha küçük çalışma alanı önyüklemesi, daha kısa oturum geçmişi, daha hafif yerel model veya daha güçlü uzun bağlam desteğine sahip bir arka uç.
4. Küçük doğrudan istekler geçmeye devam ederken OpenClaw ajan dönüşleri hâlâ arka uç içinde çöküyorsa, bunu yukarı akış sunucu/model sınırlaması olarak ele alın ve kabul edilen yük biçimiyle orada bir yeniden üretim kaydı açın.

• device identity required → güvenli olmayan bağlam veya eksik cihaz kimlik doğrulaması.
• origin not allowed → tarayıcı Origin değeri gateway.controlUi.allowedOrigins içinde değil (veya açık bir izin listesi olmadan local loopback olmayan bir tarayıcı origin'inden bağlanıyorsunuz).
• device nonce required / device nonce mismatch → istemci, challenge tabanlı cihaz kimlik doğrulama akışını (connect.challenge + device.nonce) tamamlamıyor.
• device signature invalid / device signature expired → istemci, geçerli el sıkışma için yanlış yükü (veya bayat zaman damgasını) imzaladı.
• AUTH_TOKEN_MISMATCH ile canRetryWithDeviceToken=true → istemci, önbelleğe alınmış cihaz token'ı ile bir güvenilir yeniden deneme yapabilir.
• Bu önbelleğe alınmış token yeniden denemesi, eşleştirilmiş cihaz token'ı ile saklanan önbelleğe alınmış kapsam kümesini yeniden kullanır. Açık deviceToken / açık scopes çağıranları bunun yerine istedikleri kapsam kümesini korur.
• Bu yeniden deneme yolunun dışında, bağlantı kimlik doğrulama önceliği önce açık paylaşılan token/parola, sonra açık deviceToken, sonra saklanan cihaz token'ı, sonra önyükleme token'ıdır.
• Zaman uyumsuz Tailscale Serve Control UI yolunda, aynı {scope, ip} için başarısız girişimler, sınırlayıcı hatayı kaydetmeden önce serileştirilir. Bu nedenle aynı istemciden gelen iki kötü eşzamanlı yeniden deneme, iki düz uyumsuzluk yerine ikinci denemede retry later gösterebilir.
• Tarayıcı origin'li local loopback istemcisinden too many failed authentication attempts (retry later) → aynı normalleştirilmiş Origin kaynaklı tekrarlanan hatalar geçici olarak kilitlenir; başka bir localhost origin'i ayrı bir kova kullanır.
• bu yeniden denemeden sonra tekrarlanan unauthorized → paylaşılan token/cihaz token'ı sapması; token yapılandırmasını yenileyin ve gerekiyorsa cihaz token'ını yeniden onaylayın/döndürün.
• gateway connect failed: → yanlış ana makine/port/url hedefi.

• Gateway start blocked: set gateway.mode=local veya existing config is missing gateway.mode → yerel Gateway modu etkin değil ya da yapılandırma dosyasının üzerine yazıldı ve gateway.mode kayboldu. Düzeltme: yapılandırmanızda gateway.mode="local" ayarlayın veya beklenen yerel mod yapılandırmasını yeniden damgalamak için openclaw onboard --mode local / openclaw setup komutunu yeniden çalıştırın. OpenClaw'ı Podman üzerinden çalıştırıyorsanız varsayılan yapılandırma yolu ~/.openclaw/openclaw.json olur.
• refusing to bind gateway ... without auth → geçerli bir Gateway kimlik doğrulama yolu olmadan non-loopback bağlama (token/parola veya yapılandırılmışsa güvenilir proxy).
• another gateway instance is already listening / EADDRINUSE → bağlantı noktası çakışması.
• Other gateway-like services detected (best effort) → güncel olmayan veya paralel launchd/systemd/schtasks birimleri var. Çoğu kurulum makine başına tek Gateway tutmalıdır; birden fazlasına gerçekten ihtiyacınız varsa bağlantı noktalarını + yapılandırma/durum/çalışma alanını yalıtın. Bkz. /gateway#multiple-gateways-same-host.
• Doctor'dan System-level OpenClaw gateway service detected → kullanıcı düzeyi hizmet eksikken bir systemd sistem birimi var. Doctor'ın kullanıcı hizmeti kurmasına izin vermeden önce yinelemeyi kaldırın veya devre dışı bırakın ya da sistem birimi amaçlanan gözetleyiciyse OPENCLAW_SERVICE_REPAIR_POLICY=external ayarlayın.
• Gateway service port does not match current gateway config → kurulu gözetleyici hâlâ eski --port değerini sabitliyor. openclaw doctor --fix veya openclaw gateway install --force çalıştırın, ardından Gateway hizmetini yeniden başlatın.

• Yapılandırma başlangıçta, sıcak yeniden yükleme sırasında veya OpenClaw'a ait bir yazma sırasında doğrulamadan geçmedi.
• Gateway başlangıcı openclaw.json dosyasını yeniden yazmak yerine kapalı şekilde başarısız olur.
• Sıcak yeniden yükleme, geçersiz harici düzenlemeleri atlar ve geçerli çalışma zamanı yapılandırmasını etkin tutar.
• OpenClaw'a ait yazmalar, geçersiz/yıkıcı payload'ları commit öncesi reddeder ve .rejected.* olarak kaydeder.
• openclaw doctor --fix onarımın sahibidir. JSON olmayan önekleri kaldırabilir veya reddedilen payload'u .clobbered.* olarak korurken bilinen son iyi kopyayı geri yükleyebilir.

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

• .clobbered.* var → doctor, etkin yapılandırmayı onarırken bozuk bir harici düzenlemeyi korudu.
• .rejected.* var → OpenClaw'a ait bir yapılandırma yazması, commit öncesi şema veya clobber kontrollerinden geçemedi.
• Config write rejected: → yazma, gerekli şekli bırakmaya, dosyayı keskin şekilde küçültmeye veya geçersiz yapılandırmayı kalıcılaştırmaya çalıştı.
• config reload skipped (invalid config): → doğrudan düzenleme doğrulamadan geçemedi ve çalışan Gateway tarafından yok sayıldı.
• Invalid config at ... → başlangıç, Gateway hizmetleri başlamadan önce başarısız oldu.
• missing-meta-vs-last-good, gateway-mode-missing-vs-last-good veya size-drop-vs-last-good:* → OpenClaw'a ait bir yazma, bilinen son iyi yedekle karşılaştırıldığında alanları veya boyutu kaybettiği için reddedildi.
• Config last-known-good promotion skipped → aday, *** gibi redakte edilmiş gizli değer yer tutucuları içeriyordu.

1. Doctor'ın önekli/clobbered yapılandırmayı onarmasına veya bilinen son iyi sürümü geri yüklemesine izin vermek için openclaw doctor --fix çalıştırın.
2. .clobbered.* veya .rejected.* içinden yalnızca amaçlanan anahtarları kopyalayın, ardından bunları openclaw config set veya config.patch ile uygulayın.
3. Yeniden başlatmadan önce openclaw config validate çalıştırın.
4. Elle düzenleme yapıyorsanız değiştirmek istediğiniz kısmi nesneyi değil, tam JSON5 yapılandırmasını koruyun.

• cron: scheduler disabled; jobs will not run automatically → cron devre dışı.
• cron: timer tick failed → zamanlayıcı tik işlemi başarısız oldu; dosya/günlük/çalışma zamanı hatalarını kontrol edin.
• heartbeat skipped ve reason=quiet-hours → etkin saatler penceresinin dışında.
• heartbeat skipped ve reason=empty-heartbeat-file → HEARTBEAT.md var ancak yalnızca boş satırlar / markdown başlıkları içeriyor, bu yüzden OpenClaw model çağrısını atlar.
• heartbeat skipped ve reason=no-tasks-due → HEARTBEAT.md bir tasks: bloğu içeriyor, ancak bu tikte hiçbir görevin zamanı gelmemiş.
• heartbeat: unknown accountId → heartbeat teslim hedefi için geçersiz hesap kimliği.
• heartbeat skipped ve reason=dm-blocked → heartbeat hedefi DM tarzı bir hedefe çözümlendi, ancak agents.defaults.heartbeat.directPolicy (veya ajan bazlı geçersiz kılma) block olarak ayarlı.

• unknown command "browser" veya unknown command 'browser' → birlikte gelen tarayıcı plugin'i plugins.allow tarafından dışlanmış.
• browser.enabled=true iken tarayıcı aracı eksik / kullanılamıyor → plugins.allow, browser öğesini dışlıyor; bu yüzden plugin hiç yüklenmedi.
• Failed to start Chrome CDP on port → tarayıcı süreci başlatılamadı.
• browser.executablePath not found → yapılandırılmış yol geçersiz.
• browser.cdpUrl must be http(s) or ws(s) → yapılandırılmış CDP URL'si file: veya ftp: gibi desteklenmeyen bir şema kullanıyor.
• browser.cdpUrl has invalid port → yapılandırılmış CDP URL'sinde hatalı veya aralık dışında bir bağlantı noktası var.
• Playwright is not available in this gateway build; '<feature>' is unsupported. → mevcut gateway kurulumu çekirdek tarayıcı çalışma zamanı bağımlılığından yoksun; OpenClaw'ı yeniden kurun veya güncelleyin, ardından gateway'i yeniden başlatın. ARIA anlık görüntüleri ve temel sayfa ekran görüntüleri yine de çalışabilir, ancak gezinme, AI anlık görüntüleri, CSS seçici öğe ekran görüntüleri ve PDF dışa aktarma kullanılamaz kalır.

• Could not find DevToolsActivePort for chrome → Chrome MCP existing-session, seçilen tarayıcı veri dizinine henüz bağlanamadı. Tarayıcı inceleme sayfasını açın, uzaktan hata ayıklamayı etkinleştirin, tarayıcıyı açık tutun, ilk bağlanma istemini onaylayın, sonra yeniden deneyin. Oturum açılmış durum gerekmiyorsa yönetilen openclaw profilini tercih edin.
• No Chrome tabs found for profile="user" → Chrome MCP bağlanma profilinde açık yerel Chrome sekmesi yok.
• Remote CDP for profile "<name>" is not reachable → yapılandırılmış uzak CDP uç noktasına gateway ana makinesinden erişilemiyor.
• Browser attachOnly is enabled ... not reachable veya Browser attachOnly is enabled and CDP websocket ... is not reachable → yalnızca bağlanma profilinde erişilebilir hedef yok ya da HTTP uç noktası yanıt verdi ancak CDP WebSocket yine de açılamadı.

• fullPage is not supported for element screenshots → ekran görüntüsü isteği --full-page ile --ref veya --element öğesini birlikte kullandı.
• element screenshots are not supported for existing-session profiles; use ref from snapshot. → Chrome MCP / existing-session ekran görüntüsü çağrıları CSS --element değil, sayfa yakalama veya anlık görüntü --ref kullanmalıdır.
• existing-session file uploads do not support element selectors; use ref/inputRef. → Chrome MCP yükleme kancaları CSS seçicileri değil, anlık görüntü ref'leri gerektirir.
• existing-session file uploads currently support one file at a time. → Chrome MCP profillerinde çağrı başına bir yükleme gönderin.
• existing-session dialog handling does not support timeoutMs. → Chrome MCP profillerindeki iletişim kutusu kancaları zaman aşımı geçersiz kılmalarını desteklemez.
• existing-session type does not support timeoutMs overrides. → profile="user" / Chrome MCP existing-session profillerinde act:type için timeoutMs değerini atlayın veya özel zaman aşımı gerekiyorsa yönetilen/CDP tarayıcı profili kullanın.
• existing-session evaluate does not support timeoutMs overrides. → profile="user" / Chrome MCP existing-session profillerinde act:evaluate için timeoutMs değerini atlayın veya özel zaman aşımı gerekiyorsa yönetilen/CDP tarayıcı profili kullanın.
• response body is not supported for existing-session profiles yet. → responsebody hâlâ yönetilen bir tarayıcı veya ham CDP profili gerektirir.
• yalnızca bağlanma veya uzak CDP profillerinde eski kalmış görünüm alanı / karanlık mod / yerel ayar / çevrimdışı geçersiz kılmaları → etkin denetim oturumunu kapatmak ve tüm gateway'i yeniden başlatmadan Playwright/CDP emülasyon durumunu serbest bırakmak için openclaw browser stop --browser-profile <name> çalıştırın.

openclaw gateway status
openclaw config get gateway.mode
openclaw config get gateway.remote.url
openclaw config get gateway.auth.mode

Kontrol edilecekler:

• gateway.mode=remote ise, yerel hizmetiniz sorunsuzken CLI çağrıları uzak hedefe gidiyor olabilir.
• Açık --url çağrıları depolanan kimlik bilgilerine geri dönmez.

Yaygın imzalar:

• gateway connect failed: → yanlış URL hedefi.
• unauthorized → uç noktaya erişilebiliyor ancak kimlik doğrulama yanlış.

openclaw config get gateway.bind
openclaw config get gateway.auth.mode
openclaw config get gateway.auth.token
openclaw gateway status
openclaw logs --follow

Kontrol edilecekler:

• local loopback dışı bağlamalar (lan, tailnet, custom) geçerli bir gateway kimlik doğrulama yolu gerektirir: paylaşılan token/parola kimlik doğrulaması veya doğru yapılandırılmış local loopback dışı trusted-proxy dağıtımı.
• gateway.token gibi eski anahtarlar gateway.auth.token yerine geçmez.

Yaygın imzalar:

• refusing to bind gateway ... without auth → geçerli bir gateway kimlik doğrulama yolu olmadan local loopback dışı bağlama.
• Çalışma zamanı çalışırken Connectivity probe: failed → gateway çalışıyor ancak mevcut kimlik doğrulama/url ile erişilemiyor.

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

Kontrol edilecekler:

• Pano/nodes için bekleyen cihaz onayları.
• İlke veya kimlik değişikliklerinden sonra bekleyen DM eşleştirme onayları.

Yaygın imzalar:

• device identity required → cihaz kimlik doğrulaması sağlanmadı.
• pairing required → gönderen/cihaz onaylanmalıdır.