OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Sandbox CLI

Status: active

Yalıtılmış ajan yürütmesi için sandbox çalışma ortamlarını yönetin: Docker kapsayıcıları, SSH hedefleri veya OpenShell arka uçları.

Komutlar

openclaw sandbox list

Sandbox çalışma ortamlarını durum, arka uç, yapılandırma eşleşmesi, yaş, boşta kalma süresi ve ilişkili oturum/ajan bilgileriyle listeleyin.

bash
openclaw sandbox listopenclaw sandbox list --browser  # yalnızca tarayıcı kapsayıcılarıopenclaw sandbox list --json

openclaw sandbox recreate

Geçerli yapılandırmayla yeniden oluşturulmalarını zorlamak için sandbox çalışma ortamlarını kaldırın. Çalışma ortamları, ajan bir sonraki kez kullanıldığında otomatik olarak yeniden oluşturulur.

bash
openclaw sandbox recreate --allopenclaw sandbox recreate --agent mybot        # agent:mybot:* alt oturumlarını içeriropenclaw sandbox recreate --session "agent:main:main"openclaw sandbox recreate --browser --all      # yalnızca tarayıcı kapsayıcılarıopenclaw sandbox recreate --all --force        # onayı atla

Seçenekler:

  • --all: tüm sandbox kapsayıcılarını yeniden oluşturur
  • --session <key>: çalışma ortamını bu tam kapsam anahtarıyla (sandbox list tarafından gösterildiği şekilde) yeniden oluşturur; kısa ad genişletmesi yapılmaz
  • --agent <id>: bir ajan için çalışma ortamlarını yeniden oluşturur (agent:<id> ve agent:<id>:* ile eşleşir)
  • --browser: yalnızca tarayıcı kapsayıcılarını etkiler
  • --force: onay istemini atlar

--all, --session veya --agent seçeneklerinden tam olarak birini iletin.

ssh ve OpenShell remote için yeniden oluşturma, Docker'a kıyasla daha önemlidir: ilk başlangıç verilerinin aktarılmasından sonra uzak çalışma alanı asıl kaynaktır; recreate, seçilen kapsamın bu asıl uzak çalışma alanını siler ve sonraki çalıştırma, geçerli yerel çalışma alanından yeniden başlangıç verilerini aktarır.

openclaw sandbox explain

Etkin sandbox modunu/kapsamını/çalışma alanı erişimini, sandbox araç politikasını ve yükseltilmiş araç geçitlerini (düzeltme yapılandırma anahtarı yollarıyla birlikte) inceleyin.

Rapor, workspaceRoot değerini yapılandırılmış sandbox kökü olarak korur ve etkin ana makine çalışma alanını, arka uç çalışma ortamı çalışma dizinini ve Docker bağlama tablosunu ayrı olarak gösterir. workspaceAccess: "rw" için etkin ana makine çalışma alanı, workspaceRoot altındaki bir dizin yerine ajan çalışma alanıdır.

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

recreate --session seçeneğinden farklı olarak bu komut, kısa oturum adlarını (örneğin main) kabul eder ve bunları çözümlenmiş ajana göre genişletir.

Yeniden oluşturma neden gereklidir?

Sandbox yapılandırmasını güncellemek çalışan kapsayıcıları etkilemez: mevcut çalışma ortamları eski ayarlarını korur ve boşta olan çalışma ortamları yalnızca prune.idleHours sonrasında (varsayılan 24 saat) temizlenir. Düzenli kullanılan ajanlar, güncelliğini yitirmiş çalışma ortamlarını süresiz olarak etkin tutabilir. openclaw sandbox recreate, eski çalışma ortamını kaldırır; böylece sonraki kullanımda geçerli yapılandırmadan yeniden oluşturulur.

Yaygın tetikleyiciler

Değişiklik Komut
Docker imajı güncellemesi (agents.defaults.sandbox.docker.image) openclaw sandbox recreate --all
Sandbox yapılandırması (agents.defaults.sandbox.*) openclaw sandbox recreate --all
SSH hedefi/kimlik doğrulaması (agents.defaults.sandbox.ssh.{target,workspaceRoot,identityFile,certificateFile,knownHostsFile,identityData,certificateData,knownHostsData}) openclaw sandbox recreate --all
OpenShell kaynağı/politikası/modu (plugins.entries.openshell.config.{from,mode,policy}) openclaw sandbox recreate --all
setupCommand openclaw sandbox recreate --all (veya tek bir ajan için --agent <id>)

Kayıt defteri geçişi

Sandbox çalışma ortamı meta verileri, paylaşılan SQLite durum veritabanında bulunur. Eski kurulumlarda, normal okumaların artık yeniden yazmadığı eski kayıt defteri dosyaları bulunabilir:

  • ~/.openclaw/sandbox/containers.json
  • ~/.openclaw/sandbox/browsers.json
  • ~/.openclaw/sandbox/containers/ veya ~/.openclaw/sandbox/browsers/ altında kapsayıcı/tarayıcı başına bir JSON parçası

Geçerli eski girdileri SQLite'a taşımak için openclaw doctor --fix komutunu çalıştırın. Bozuk eski bir kayıt defterinin geçerli çalışma ortamı girdilerini gizleyememesi için geçersiz eski dosyalar karantinaya alınır.

Yapılandırma

Sandbox ayarları, ~/.openclaw/openclaw.json dosyasında agents.defaults.sandbox altında bulunur (ajan başına geçersiz kılmalar agents.list[].sandbox içine yazılır):

jsonc
{  "agents": {    "defaults": {      "sandbox": {        "mode": "all", // off, non-main, all        "backend": "docker", // docker, ssh, openshell (plugin tarafından sağlanır)        "scope": "agent", // session, agent, shared        "docker": {          "image": "openclaw-sandbox:bookworm-slim",          "containerPrefix": "openclaw-sbx-",          // ... diğer Docker seçenekleri        },        "prune": {          "idleHours": 24, // 24 saat boşta kaldıktan sonra otomatik temizle          "maxAgeDays": 7, // 7 gün sonra otomatik temizle        },      },    },  },}

İlgili

Was this useful?
On this page

On this page