Skip to main content
Gestisci i runtime sandbox per l’esecuzione isolata degli agenti: container Docker, destinazioni SSH o backend OpenShell.

​
Comandi

​
openclaw sandbox list

Elenca i runtime sandbox con stato, backend, corrispondenza della configurazione, età, tempo di inattività e sessione/agente associato.

​
openclaw sandbox recreate

Rimuove i runtime sandbox per forzarne la ricreazione con la configurazione corrente. I runtime vengono ricreati automaticamente al successivo utilizzo dell’agente.
Opzioni:
  • --all: ricrea tutti i container sandbox
  • --session <key>: ricrea il runtime con questa chiave di ambito esatta (come mostrata da sandbox list); nessuna espansione dei nomi abbreviati
  • --agent <id>: ricrea i runtime per un agente (corrisponde a agent:<id> e agent:<id>:*)
  • --browser: interessa solo i container del browser
  • --force: ignora la richiesta di conferma
Specifica esattamente una tra --all, --session e --agent. Per ssh e OpenShell remote, la ricreazione è più rilevante che con Docker: dopo il popolamento iniziale, lo spazio di lavoro remoto è quello canonico; recreate elimina tale spazio di lavoro remoto canonico per l’ambito selezionato e l’esecuzione successiva lo ripopola dallo spazio di lavoro locale corrente.

​
openclaw sandbox explain

Esamina la modalità e l’ambito sandbox effettivi, l’accesso allo spazio di lavoro, i criteri degli strumenti sandbox e i controlli per gli strumenti con privilegi elevati (con i percorsi delle chiavi di configurazione da correggere). Il rapporto mantiene workspaceRoot come radice sandbox configurata e mostra separatamente lo spazio di lavoro host effettivo, la directory di lavoro del runtime del backend e la tabella dei montaggi Docker. Con workspaceAccess: "rw", lo spazio di lavoro host effettivo è lo spazio di lavoro dell’agente anziché una directory sotto workspaceRoot.
A differenza di recreate --session, questo comando accetta nomi di sessione abbreviati (ad esempio main) e li espande in base all’agente risolto.

​
Perché è necessaria la ricreazione

L’aggiornamento della configurazione sandbox non influisce sui container in esecuzione: i runtime esistenti mantengono le impostazioni precedenti e quelli inattivi vengono rimossi solo dopo prune.idleHours (valore predefinito: 24 ore). Gli agenti utilizzati regolarmente possono mantenere attivi indefinitamente runtime obsoleti. openclaw sandbox recreate rimuove il vecchio runtime affinché, al successivo utilizzo, venga ricostruito dalla configurazione corrente.
Preferisci openclaw sandbox recreate alla pulizia manuale specifica del backend. Usa il registro dei runtime del Gateway ed evita incongruenze quando cambiano l’ambito o le chiavi di sessione.

​
Cause comuni

I runtime vengono ricreati automaticamente al successivo utilizzo dell’agente.

​
Migrazione del registro

I metadati dei runtime sandbox risiedono nel database di stato SQLite condiviso. Le installazioni meno recenti possono contenere file di registro legacy che le normali operazioni di lettura non riscrivono più:
  • ~/.openclaw/sandbox/containers.json
  • ~/.openclaw/sandbox/browsers.json
  • un frammento JSON per ogni container/browser in ~/.openclaw/sandbox/containers/ o ~/.openclaw/sandbox/browsers/
Esegui openclaw doctor --fix per migrare in SQLite le voci legacy valide. I file legacy non validi vengono messi in quarantena, così un vecchio registro danneggiato non può nascondere le voci dei runtime correnti.

​
Configurazione

Le impostazioni sandbox si trovano in ~/.openclaw/openclaw.json, sotto agents.defaults.sandbox (le sostituzioni specifiche per agente vanno in agents.list[].sandbox):

​
Argomenti correlati