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).

openclaw sandbox explainopenclaw sandbox explain --session agent:main:mainopenclaw sandbox explain --agent workopenclaw sandbox explain --json

openclaw sandbox list

Tüm sandbox çalışma zamanlarını durumları ve yapılandırmalarıyla listeleyin.

openclaw sandbox listopenclaw sandbox list --browser  # List only browser containersopenclaw 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.

openclaw sandbox recreate --all                # Recreate all containersopenclaw sandbox recreate --session main       # Specific sessionopenclaw sandbox recreate --agent mybot        # Specific agentopenclaw sandbox recreate --browser            # Only browser containersopenclaw sandbox recreate --all --force        # Skip confirmation

Seçenekler:

• --all: Tüm sandbox container'larını yeniden oluştur
• --session <key>: Belirli oturum için container'ı yeniden oluştur
• --agent <id>: Belirli agent için container'ları yeniden oluştur
• --browser: Yalnızca tarayıcı container'larını yeniden oluştur
• --force: Onay istemini atla

Kullanım örnekleri

Bir Docker imajını güncelledikten sonra

# Pull new imagedocker pull openclaw-sandbox:latestdocker 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 containersopenclaw sandbox recreate --all

Sandbox yapılandırmasını değiştirdikten sonra

# Edit config: agents.defaults.sandbox.* (or agents.list[].sandbox.*) # Recreate to apply new configopenclaw sandbox recreate --all

SSH hedefini veya SSH kimlik doğrulama malzemesini değiştirdikten sonra

# 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

# 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

openclaw sandbox recreate --all# or just one agent:openclaw sandbox recreate --agent family

Yalnızca belirli bir agent için

# Update only one agent's containersopenclaw 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.

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):

{  "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ı
• Sandboxing
• Agent çalışma alanı
• Doctor: sandbox kurulumunu denetler.