Skip to main content
Gérez les environnements d’exécution sandbox pour l’exécution isolée des agents : conteneurs Docker, cibles SSH ou backends OpenShell.

​
Commandes

​
openclaw sandbox list

Répertorie les environnements d’exécution sandbox avec leur état, leur backend, la correspondance de configuration, leur ancienneté, leur durée d’inactivité et la session ou l’agent associé.

​
openclaw sandbox recreate

Supprime les environnements d’exécution sandbox pour forcer leur recréation avec la configuration actuelle. Ils sont automatiquement recréés lors de la prochaine utilisation de l’agent.
Options :
  • --all : recrée tous les conteneurs sandbox
  • --session <key> : recrée l’environnement d’exécution correspondant exactement à cette clé de portée (telle qu’affichée par sandbox list) ; aucune expansion des noms courts
  • --agent <id> : recrée les environnements d’exécution d’un agent (correspond à agent:<id> et agent:<id>:*)
  • --browser : affecte uniquement les conteneurs de navigateur
  • --force : ignore l’invite de confirmation
Transmettez exactement une option parmi --all, --session et --agent. Pour ssh et le mode remote d’OpenShell, la recréation est plus importante qu’avec Docker : après l’initialisation, l’espace de travail distant fait autorité ; recreate supprime cet espace de travail distant de référence pour la portée sélectionnée, et l’exécution suivante le réinitialise à partir de l’espace de travail local actuel.

​
openclaw sandbox explain

Inspecte le mode et la portée effectifs du sandbox, l’accès à l’espace de travail, la politique des outils du sandbox et les contrôles des outils à privilèges élevés, avec les chemins des clés de configuration à corriger. Le rapport conserve workspaceRoot comme racine du sandbox configurée et affiche séparément l’espace de travail hôte effectif, le répertoire de travail du backend d’exécution et la table des montages Docker. Avec workspaceAccess: "rw", l’espace de travail hôte effectif est celui de l’agent plutôt qu’un répertoire situé sous workspaceRoot.
Contrairement à recreate --session, cette commande accepte les noms de session courts, par exemple main, et les développe en fonction de l’agent résolu.

​
Pourquoi la recréation est nécessaire

La mise à jour de la configuration du sandbox n’affecte pas les conteneurs en cours d’exécution : les environnements d’exécution existants conservent leurs anciens paramètres, et ceux qui sont inactifs ne sont supprimés qu’après prune.idleHours (24 h par défaut). Les agents régulièrement utilisés peuvent ainsi conserver indéfiniment des environnements d’exécution obsolètes. openclaw sandbox recreate supprime l’ancien environnement afin que sa prochaine utilisation le reconstruise à partir de la configuration actuelle.
Préférez openclaw sandbox recreate à un nettoyage manuel propre à chaque backend. Cette commande utilise le registre des environnements d’exécution du Gateway et évite les incohérences lorsque la portée ou les clés de session changent.

​
Déclencheurs courants

Les environnements d’exécution sont automatiquement recréés lors de la prochaine utilisation de l’agent.

​
Migration du registre

Les métadonnées des environnements d’exécution sandbox résident dans la base de données d’état SQLite partagée. Les anciennes installations peuvent comporter des fichiers de registre hérités qui ne sont plus réécrits lors des lectures ordinaires :
  • ~/.openclaw/sandbox/containers.json
  • ~/.openclaw/sandbox/browsers.json
  • un fragment JSON par conteneur ou navigateur sous ~/.openclaw/sandbox/containers/ ou ~/.openclaw/sandbox/browsers/
Exécutez openclaw doctor --fix pour migrer les entrées héritées valides vers SQLite. Les fichiers hérités non valides sont placés en quarantaine afin qu’un ancien registre corrompu ne puisse pas masquer les entrées actuelles des environnements d’exécution.

​
Configuration

Les paramètres du sandbox se trouvent dans ~/.openclaw/openclaw.json, sous agents.defaults.sandbox (les substitutions propres à chaque agent se placent dans agents.list[].sandbox) :

​
Voir aussi