Ana içeriğe atla

​
FAQ

Gerçek dünyadaki kurulumlar için hızlı yanıtlar ve daha derin sorun giderme (yerel geliştirme, VPS, çoklu ajan, OAuth/API anahtarları, model devre dışı bırakma). Çalışma zamanı tanılamaları için Sorun Giderme sayfasına bakın. Tam yapılandırma referansı için Yapılandırma sayfasını inceleyin.

​
İçindekiler

​
First 60 seconds if something’s broken

  1. Quick status (first check) 
    openclaw status
    Fast local summary: OS + update, gateway/service reachability, agents/sessions, provider config + runtime issues (when gateway is reachable).
  2. Pasteable report (safe to share) 
    openclaw status --all
    Read-only diagnosis with log tail (tokens redacted).
  3. Daemon + port state 
    openclaw gateway status
    Shows supervisor runtime vs RPC reachability, the probe target URL, and which config the service likely used.
  4. Deep probes 
    openclaw status --deep
    Runs gateway health checks + provider probes (requires a reachable gateway). See Health.
  5. Tail the latest log 
    openclaw logs --follow
    If RPC is down, fall back to: 
    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
    File logs are separate from service logs; see Logging and Troubleshooting.
  6. Run the doctor (repairs) 
    openclaw doctor
    Repairs/migrates config/state + runs health checks. See Doctor.
  7. Gateway snapshot 
    openclaw health --json
openclaw health --verbose   # shows the target URL + config path on errors
    Asks the running gateway for a full snapshot (WS-only). See Health.

​
Hızlı başlangıç ve ilk çalıştırma kurulumu

​
Im stuck whats the fastest way to get unstuck

Makinenizi görebilen yerel bir AI ajanı kullanın. Discord’da sormaktan çok daha etkilidir, çünkü “takıldım” vakalarının çoğu uzaktan yardımcıların inceleyemeyeceği yerel config veya ortam sorunlarıdır. Bu araçlar repo’yu okuyabilir, komut çalıştırabilir, logları inceleyebilir ve makine seviyesindeki kurulumunuzu (PATH, servisler, izinler, auth dosyaları) düzeltebilir. Onlara hacklenebilir (git) kurulum üzerinden tam kaynak checkout verin: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Bu, OpenClaw’ı git checkout’tan kurar; böylece ajan çalıştırdığınız sürümün kodunu + dokümanlarını okuyabilir. Daha sonra installer’ı --install-method git olmadan yeniden çalıştırarak stable’a geri dönebilirsiniz. İpucu: Ajanın düzeltmeyi planlamasını ve denetlemesini (adım adım) isteyin, ardından yalnızca gerekli komutları çalıştırın. Bu, değişiklikleri küçük ve denetlenebilir tutar. Gerçek bir bug veya düzeltme bulursanız, lütfen bir GitHub issue açın veya PR gönderin: https://github.com/openclaw/openclaw/issues
https://github.com/openclaw/openclaw/pulls Yardım isterken şu komutlarla başlayın (çıktıları paylaşın): 
openclaw status
openclaw models status
openclaw doctor
Ne yaparlar:
  • openclaw status: gateway/agent sağlığı + temel config’in hızlı özeti.
  • openclaw models status: sağlayıcı auth + model erişilebilirliğini kontrol eder.
  • openclaw doctor: yaygın config/durum sorunlarını doğrular ve onarır.
Diğer faydalı CLI kontrolleri: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose. Hızlı debug döngüsü: First 60 seconds if something’s broken.
Kurulum dokümanları: Install, Installer flags, Updating.

​
Ekran görüntüsündeki/sohbet kaydındaki soruya birebir yanıt

S: “Anthropic için bir API anahtarıyla varsayılan model nedir?” C: OpenClaw’da kimlik bilgileri (credentials) ile model seçimi birbirinden ayrıdır. ANTHROPIC_API_KEY ayarlamak (veya Anthropic API anahtarını auth profillerinde saklamak) yalnızca kimlik doğrulamayı etkinleştirir. Gerçek varsayılan model, agents.defaults.model.primary içinde yapılandırdığınız değerdir (örneğin anthropic/claude-sonnet-4-5 veya anthropic/claude-opus-4-6). Eğer No credentials found for profile "anthropic:default" hatasını görüyorsanız, bu çalışan ajan için beklenen auth-profiles.json dosyasında Anthropic kimlik bilgilerinin bulunamadığı anlamına gelir.
Hâlâ takıldınız mı? Discord üzerinden sorun veya bir GitHub discussion açın.