Skip to main content

​
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)
    Fast local summary: OS + update, gateway/service reachability, agents/sessions, provider config + runtime issues (when gateway is reachable).
  2. Pasteable report (safe to share)
    Read-only diagnosis with log tail (tokens redacted).
  3. Daemon + port state
    Shows supervisor runtime vs RPC reachability, the probe target URL, and which config the service likely used.
  4. Deep probes
    Runs gateway health checks + provider probes (requires a reachable gateway). See Health.
  5. Tail the latest log
    If RPC is down, fall back to:
    File logs are separate from service logs; see Logging and Troubleshooting.
  6. Run the doctor (repairs)
    Repairs/migrates config/state + runs health checks. See Doctor.
  7. Gateway snapshot
    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:
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):
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.