> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Korumalı Alan CLI Yalıtılmış agent yürütmesi için sandbox çalışma zamanlarını yönetin. ## Genel Bakış OpenClaw, güvenlik için agent'ları yalıtılmış sandbox çalışma zamanlarında çalıştırabilir. `sandbox` komutları, güncellemelerden veya yapılandırma değişikliklerinden sonra bu çalışma zamanlarını incelemenize ve yeniden oluşturmanıza yardımcı olur. Bugün bu genellikle şu anlama gelir: * Docker sandbox container'ları * `agents.defaults.sandbox.backend = "ssh"` olduğunda SSH sandbox çalışma zamanları * `agents.defaults.sandbox.backend = "openshell"` olduğunda OpenShell sandbox çalışma zamanları `ssh` ve OpenShell `remote` için yeniden oluşturma Docker'a göre daha önemlidir: * ilk tohumlamadan sonra uzak çalışma alanı kanoniktir * `openclaw sandbox recreate`, seçilen kapsam için bu kanonik uzak çalışma alanını siler * sonraki kullanım, geçerli yerel çalışma alanından tekrar tohumlar ## Komutlar ### `openclaw sandbox explain` **Etkin** sandbox modu/kapsamı/çalışma alanı erişimini, sandbox araç ilkesini ve yükseltilmiş geçitleri inceleyin (düzeltme yapılandırma anahtarı yollarıyla). ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sandbox explain openclaw sandbox explain --session agent:main:main openclaw sandbox explain --agent work openclaw sandbox explain --json ``` ### `openclaw sandbox list` Tüm sandbox çalışma zamanlarını durumları ve yapılandırmalarıyla listeleyin. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sandbox list openclaw sandbox list --browser # List only browser containers openclaw sandbox list --json # JSON output ``` **Çıktı şunları içerir:** * Çalışma zamanı adı ve durumu * Backend (`docker`, `openshell` vb.) * Yapılandırma etiketi ve geçerli yapılandırmayla eşleşip eşleşmediği * Yaş (oluşturulmasından bu yana geçen süre) * Boşta kalma süresi (son kullanımdan bu yana geçen süre) * İlişkili oturum/agent ### `openclaw sandbox recreate` Güncellenmiş yapılandırmayla yeniden oluşturmayı zorlamak için sandbox çalışma zamanlarını kaldırın. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sandbox recreate --all # Recreate all containers openclaw sandbox recreate --session main # Specific session openclaw sandbox recreate --agent mybot # Specific agent openclaw sandbox recreate --browser # Only browser containers openclaw sandbox recreate --all --force # Skip confirmation ``` **Seçenekler:** * `--all`: Tüm sandbox container'larını yeniden oluştur * `--session `: Belirli oturum için container'ı yeniden oluştur * `--agent `: Belirli agent için container'ları yeniden oluştur * `--browser`: Yalnızca tarayıcı container'larını yeniden oluştur * `--force`: Onay istemini atla Çalışma zamanları, agent bir sonraki kez kullanıldığında otomatik olarak yeniden oluşturulur. ## Kullanım örnekleri ### Bir Docker imajını güncelledikten sonra ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Pull new image docker pull openclaw-sandbox:latest docker tag openclaw-sandbox:latest openclaw-sandbox:bookworm-slim # Update config to use new image # Edit config: agents.defaults.sandbox.docker.image (or agents.list[].sandbox.docker.image) # Recreate containers openclaw sandbox recreate --all ``` ### Sandbox yapılandırmasını değiştirdikten sonra ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Edit config: agents.defaults.sandbox.* (or agents.list[].sandbox.*) # Recreate to apply new config openclaw sandbox recreate --all ``` ### SSH hedefini veya SSH kimlik doğrulama malzemesini değiştirdikten sonra ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Edit config: # - agents.defaults.sandbox.backend # - agents.defaults.sandbox.ssh.target # - agents.defaults.sandbox.ssh.workspaceRoot # - agents.defaults.sandbox.ssh.identityFile / certificateFile / knownHostsFile # - agents.defaults.sandbox.ssh.identityData / certificateData / knownHostsData openclaw sandbox recreate --all ``` Çekirdek `ssh` backend'i için yeniden oluşturma, SSH hedefindeki kapsam başına uzak çalışma alanı kökünü siler. Sonraki çalıştırma, yerel çalışma alanından tekrar tohumlar. ### OpenShell kaynağını, ilkesini veya modunu değiştirdikten sonra ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Edit config: # - agents.defaults.sandbox.backend # - plugins.entries.openshell.config.from # - plugins.entries.openshell.config.mode # - plugins.entries.openshell.config.policy openclaw sandbox recreate --all ``` OpenShell `remote` modu için yeniden oluşturma, o kapsamın kanonik uzak çalışma alanını siler. Sonraki çalıştırma, yerel çalışma alanından tekrar tohumlar. ### setupCommand'ı değiştirdikten sonra ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sandbox recreate --all # or just one agent: openclaw sandbox recreate --agent family ``` ### Yalnızca belirli bir agent için ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Update only one agent's containers openclaw sandbox recreate --agent alfred ``` ## Buna neden ihtiyaç duyulur? Sandbox yapılandırmasını güncellediğinizde: * Mevcut çalışma zamanları eski ayarlarla çalışmaya devam eder. * Çalışma zamanları yalnızca 24 saatlik hareketsizlikten sonra budanır. * Düzenli kullanılan agent'lar eski çalışma zamanlarını süresiz olarak canlı tutar. Eski çalışma zamanlarının kaldırılmasını zorlamak için `openclaw sandbox recreate` kullanın. Gerektiğinde, geçerli ayarlarla otomatik olarak yeniden oluşturulurlar. Manuel backend'e özgü temizlik yerine `openclaw sandbox recreate` kullanmayı tercih edin. Gateway'in çalışma zamanı kayıt defterini kullanır ve kapsam veya oturum anahtarları değiştiğinde uyumsuzlukları önler. ## Kayıt defteri geçişi OpenClaw, sandbox çalışma zamanı meta verilerini paylaşılan SQLite durum veritabanında saklar. Eski kurulumlarda hâlâ eski sandbox kayıt defteri dosyaları bulunabilir: * `~/.openclaw/sandbox/containers.json` * `~/.openclaw/sandbox/browsers.json` Bazı yükseltmelerde `~/.openclaw/sandbox/containers/` veya `~/.openclaw/sandbox/browsers/` altında container/tarayıcı başına bir JSON parçası da bulunabilir. Normal sandbox çalışma zamanı okumaları bu eski kaynakları yeniden yazmaz. Geçerli eski girdileri SQLite'a taşımak için `openclaw doctor --fix` çalıştırın. Geçersiz eski dosyalar karantinaya alınır, böylece tek bir bozuk eski kayıt defteri geçerli çalışma zamanı girdilerini gizleyemez. ## Yapılandırma Sandbox ayarları `~/.openclaw/openclaw.json` içinde `agents.defaults.sandbox` altında bulunur (agent başına geçersiz kılmalar `agents.list[].sandbox` içine gider): ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "agents": { "defaults": { "sandbox": { "mode": "all", // off, non-main, all "backend": "docker", // docker, ssh, openshell "scope": "agent", // session, agent, shared "docker": { "image": "openclaw-sandbox:bookworm-slim", "containerPrefix": "openclaw-sbx-", // ... more Docker options }, "prune": { "idleHours": 24, // Auto-prune after 24h idle "maxAgeDays": 7, // Auto-prune after 7 days }, }, }, }, } ``` ## İlgili * [CLI referansı](/tr/cli) * [Sandboxing](/tr/gateway/sandboxing) * [Agent çalışma alanı](/tr/concepts/agent-workspace) * [Doctor](/tr/gateway/doctor): sandbox kurulumunu denetler.