Maneja tus contenedores de Sandbox con la CLI de OpenClaw

¿Te ha pasado que actualizas una configuración o una imagen de Docker y el sistema parece ignorar los cambios? Es un problema común cuando trabajas con entornos aislados: los contenedores antiguos se quedan activos y tus agentes siguen ejecutándose en versiones obsoletas.

Para solucionar esto, OpenClaw incluye herramientas específicas en su CLI que te permiten controlar exactamente qué está pasando dentro de tus sandboxes sin tener que pelearte manualmente con comandos de Docker.

Requisitos previos

Para seguir esta guía, asegúrate de cumplir con lo siguiente:

• Tener instalada la CLI de openclaw.
• Docker instalado y configurado en tu máquina.
• Un archivo de configuración en ~/.openclaw/openclaw.json.

Inicio rápido

Si quieres limpiar todo y empezar de cero con la configuración más reciente, el camino más rápido es forzar la recreación de todos los contenedores. Ejecuta este comando en tu terminal:

openclaw sandbox recreate --all --force

Este comando elimina los contenedores actuales. No te preocupes por perder el acceso; OpenClaw los volverá a crear automáticamente la próxima vez que utilices un agente.

Comandos esenciales

Aquí tienes las herramientas principales para gestionar tu entorno:

1. Inspeccionar el estado con explain Usa este comando para ver el modo de sandbox efectivo, el alcance (scope) y qué herramientas tienen permisos elevados.

openclaw sandbox explain
openclaw sandbox explain --session agent:main:main

2. Listar contenedores activos Si necesitas ver qué está corriendo, el nombre del contenedor y cuánto tiempo lleva inactivo, usa list.

openclaw sandbox list
openclaw sandbox list --browser  # Solo contenedores de navegador

3. Recrear según necesidad Puedes ser específico y no borrar todo. Si solo has modificado un agente, actúa solo sobre él.

openclaw sandbox recreate --agent alfred
openclaw sandbox recreate --session main

Solución de problemas

Si notas que tus agentes no reflejan los cambios de configuración, revisa estos puntos basados en el comportamiento por defecto de la CLI:

• Contenedores persistentes: OpenClaw solo elimina contenedores automáticamente tras 24 horas de inactividad. Si usas un agente constantemente, su contenedor nunca se cerrará por sí solo.
• Desajuste de imágenes: Si haces un docker pull de una nueva imagen, los contenedores que ya están corriendo seguirán usando la imagen antigua hasta que uses recreate.
• Nombres de contenedores: Evita usar docker rm manualmente. La CLI utiliza el naming del Gateway para evitar errores cuando cambian las claves de sesión o el scope.
• Configuración de red o volumen: Cualquier cambio en agents.defaults.sandbox requiere que recrees los contenedores para que Docker aplique los nuevos parámetros.

Configuración

Puedes ajustar el comportamiento del sandbox en tu archivo ~/.openclaw/openclaw.json. Aquí tienes un ejemplo de cómo definir el modo, la imagen y las reglas de limpieza:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "all", // off, non-main, all
        "scope": "agent", // session, agent, shared
        "docker": {
          "image": "openclaw-sandbox:bookworm-slim",
          "containerPrefix": "openclaw-sbx-",
          // ... más opciones de Docker
        },
        "prune": {
          "idleHours": 24, // Limpieza automática tras 24h de inactividad
          "maxAgeDays": 7, // Limpieza automática tras 7 días
        },
      },
    },
  },
}

Si necesitas ayuda personalizada para configurar tu entorno, consulta nuestro AI Setup Assistant.

Próximos pasos

• Sandbox Documentation
• Agent Configuration
• Doctor Command