Skip to main content
Kelola runtime sandbox untuk eksekusi agen yang terisolasi: kontainer Docker, target SSH, atau backend OpenShell.

​
Perintah

​
openclaw sandbox list

Cantumkan runtime sandbox beserta status, backend, kecocokan konfigurasi, usia, waktu menganggur, dan sesi/agen terkait.

​
openclaw sandbox recreate

Hapus runtime sandbox untuk memaksanya dibuat ulang dengan konfigurasi saat ini. Runtime dibuat ulang secara otomatis saat agen digunakan berikutnya.
Opsi:
  • --all: buat ulang semua kontainer sandbox
  • --session <key>: buat ulang runtime dengan kunci cakupan persis ini (seperti yang ditampilkan oleh sandbox list); tanpa perluasan nama pendek
  • --agent <id>: buat ulang runtime untuk satu agen (cocok dengan agent:<id> dan agent:<id>:*)
  • --browser: hanya memengaruhi kontainer peramban
  • --force: lewati permintaan konfirmasi
Berikan tepat satu dari --all, --session, atau --agent. Untuk ssh dan OpenShell remote, pembuatan ulang lebih penting daripada pada Docker: ruang kerja jarak jauh menjadi sumber kanonis setelah penyemaian awal, recreate menghapus ruang kerja jarak jauh kanonis tersebut untuk cakupan yang dipilih, dan proses berikutnya menyemainya kembali dari ruang kerja lokal saat ini.

​
openclaw sandbox explain

Periksa mode/cakupan/akses ruang kerja sandbox yang efektif, kebijakan alat sandbox, dan gerbang alat dengan hak istimewa lebih tinggi (beserta jalur kunci konfigurasi untuk perbaikannya). Laporan mempertahankan workspaceRoot sebagai akar sandbox yang dikonfigurasi dan menampilkan secara terpisah ruang kerja host yang efektif, direktori kerja runtime backend, serta tabel pemasangan Docker. Untuk workspaceAccess: "rw", ruang kerja host yang efektif adalah ruang kerja agen, bukan direktori di bawah workspaceRoot.
Tidak seperti recreate --session, perintah ini menerima nama sesi pendek (misalnya main) dan memperluasnya berdasarkan agen yang telah ditentukan.

​
Mengapa pembuatan ulang diperlukan

Memperbarui konfigurasi sandbox tidak memengaruhi kontainer yang sedang berjalan: runtime yang ada mempertahankan pengaturan lamanya, dan runtime yang menganggur baru dibersihkan setelah prune.idleHours (bawaan 24 jam). Agen yang digunakan secara rutin dapat mempertahankan runtime usang tetap aktif tanpa batas waktu. openclaw sandbox recreate menghapus runtime lama agar penggunaan berikutnya membangunnya kembali dari konfigurasi saat ini.
Utamakan openclaw sandbox recreate daripada pembersihan manual khusus backend. Perintah ini menggunakan registri runtime milik Gateway dan menghindari ketidakcocokan ketika cakupan atau kunci sesi berubah.

​
Pemicu umum

Runtime dibuat ulang secara otomatis saat agen digunakan berikutnya.

​
Migrasi registri

Metadata runtime sandbox berada dalam basis data status SQLite bersama. Instalasi lama mungkin memiliki berkas registri warisan yang tidak lagi ditulis ulang oleh pembacaan biasa:
  • ~/.openclaw/sandbox/containers.json
  • ~/.openclaw/sandbox/browsers.json
  • satu pecahan JSON per kontainer/peramban di bawah ~/.openclaw/sandbox/containers/ atau ~/.openclaw/sandbox/browsers/
Jalankan openclaw doctor --fix untuk memigrasikan entri warisan yang valid ke SQLite. Berkas warisan yang tidak valid dikarantina agar registri lama yang rusak tidak dapat menyembunyikan entri runtime saat ini.

​
Konfigurasi

Pengaturan sandbox berada di ~/.openclaw/openclaw.json pada agents.defaults.sandbox (penggantian per agen ditempatkan di agents.list[].sandbox):

​
Terkait