Disk Cleaner (disk-sweeper) para Openclaw

Disk Cleaner es una herramienta de línea de comandos inteligente diseñada para analizar de forma segura el uso del disco, identificar archivos grandes, detectar duplicados mediante hash SHA-256 y limpiar de forma segura las cachés de las aplicaciones.

harrylabsj
v1.0.0
Jun 14, 2026
0
568
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install disk-sweeper

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar disk-sweeper usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Disk Cleaner (disk-sweeper)?

Disk Cleaner (disk-sweeper) es una utilidad de análisis y limpieza del sistema de alto rendimiento disponible a través de Openclaw Skills. Diseñada para desarrolladores y usuarios avanzados, esta herramienta CLI ejecuta escaneos recursivos de directorios para desglosar la distribución del almacenamiento por tipo de archivo, tamaño y antigüedad. Lo que la hace única son sus estrictas medidas de seguridad: protege los directorios críticos del sistema y utiliza un marco de clasificación de seguridad multinivel para garantizar que nunca elimine archivos esenciales.

Más allá de la limpieza básica, la herramienta destaca en su capacidad para detectar cachés profundas de aplicaciones, atacando específicamente a los grandes consumidores de recursos como cachés de macOS, Xcode, Docker, node_modules y las principales herramientas de productividad chinas (WeChat, DingTalk, QQ, Baidu, WPS). Funciona totalmente offline, garantiza cero exposición a la red y aprovecha un algoritmo inteligente de deduplicación SHA-256 de múltiples pasadas para localizar y recuperar el espacio desperdiciado por archivos duplicados.

Casos de uso de Disk Cleaner (disk-sweeper)

Aquí hay formas comunes de utilizar esta utilidad desde el directorio de Openclaw Skills:

  • Recuperar almacenamiento de desarrollador: Escanee y elimine instantáneamente acumulaciones pesadas de caché de imágenes de Docker, Xcode DerivedData, node_modules de npm/yarn y paquetes de Homebrew.
  • Limpieza de caché de aplicaciones: Identifique y purgue de forma segura directorios de caché masivos creados por herramientas de comunicación como WeChat, DingTalk y QQ sin interrumpir los registros de chat.
  • Auditoría de espacio del sistema: Ejecute escaneos de transmisión en tiempo real en sus directorios de inicio para generar informes visuales claros de archivos grandes y uso general del disco.
  • Detección de archivos duplicados: Agrupe y detecte archivos exactamente duplicados mediante clasificación por tamaño y hash de contenido SHA-256 en capas para desduplicar archivos y medios de forma segura.
  • Mantenimiento automatizado: Configure trabajos cron de escaneo semanal programados para realizar un seguimiento del estado del disco y generar resúmenes JSON estructurados para su monitoreo.

Cómo funciona Disk Cleaner (disk-sweeper)

Esta herramienta sigue un proceso de ejecución estructurado de cinco pasos cuando se activa a través de Openclaw Skills:

  1. Escaneo de sistema de archivos en transmisión: El motor scanner.py escanea la ruta de destino de forma asíncrona, omitiendo automáticamente los directorios protegidos por el sistema y los directorios sin permisos de acceso.
  2. Agregación multidimensional: El motor analyzer.py procesa los archivos en tiempo real, agrupándolos por tipo, tamaño, profundidad del directorio, extensión y antigüedad del archivo.
  3. Verificación de deduplicación: Para la detección de duplicados, la herramienta agrupa las posibles coincidencias por tamaño primero, luego analiza los hashes de encabezado y completa los hashes de contenido SHA-256 completos para garantizar coincidencias perfectas sin sobrecarga.
  4. Análisis de clasificación de seguridad: El motor de seguridad evalúa las rutas frente a una matriz de protección y patrones codificados para etiquetar archivos con grados de riesgo codificados por colores (Seguro, Limpiable, Precaución, Protegido).
  5. Ejecución segura: Realiza vistas previas por defecto. Tras la confirmación, los archivos se envían de forma segura a la Papelera del sistema (usando APIs nativas) en lugar de una eliminación permanente, proporcionando una red de seguridad instantánea.

Configuración de Disk Cleaner (disk-sweeper)

Empiece con Disk Cleaner directamente desde el registro de Openclaw Skills:

# Instale la habilidad disk-sweeper globalmente
clawhub install disk-sweeper

# Ejecute un escaneo rápido y seguro de su directorio de inicio
clawhub run disk-sweeper scan --paths ~/

# Obtenga una vista previa segura de los elementos limpiables sin eliminar nada
clawhub run disk-sweeper clean --mode preview

# Ejecute de forma segura la limpieza automatizada para los elementos marcados como verdes (Seguro)
clawhub run disk-sweeper clean --mode auto-safe --confirm

Esquema de datos y taxonomía de Disk Cleaner (disk-sweeper)

La habilidad Disk Cleaner está estructurada de forma modular para desacoplar las operaciones del sistema de archivos, el análisis y las definiciones de reglas. A continuación se muestra la arquitectura de archivos del proyecto y el schema de metadatos utilizado en esta entrada de Openclaw Skills:

Estructura del directorio del proyecto

disk-sweeper/
├── SKILL.md                 # Definiciones y documentación de la habilidad
├── scripts/
│   ├── scanner.py           # Escáner de sistema de archivos (transmisión + progreso)
│   ├── analyzer.py          # Motor de análisis de espacio
│   ├── duplicates.py        # Detección de archivos duplicados (SHA-256)
│   ├── caches.py            # Reconocimiento de caché de aplicación
│   ├── safety.py            # Clasificación de seguridad + lista de protección
│   ├── cleaner.py           # Ejecutor de limpieza (papelera/eliminar/deshacer)
│   ├── formatter.py         # Formateo de informes
│   └── progress.py          # Barra de progreso + salida de estado
└── references/
    ├── protected-paths.json # Definiciones de protección de rutas del sistema
    ├── cache-patterns.json  # Expresiones regulares y rutas de caché de aplicaciones
    └── file-types.json      # Asignaciones de extensión a categoría

Matriz de clasificación de seguridad

Grado Indicador de color Justificación / Acción
SAFE Verde Cachés reconstruibles (ej. npm, pip) que se pueden borrar de forma segura
CLEANABLE Amarillo Activos de desarrollo no utilizados (ej. Xcode DerivedData, imágenes de Docker)
CAUTION Naranja Cachés de aplicaciones que contienen datos de usuario o archivos adjuntos (ej. WeChat, QQ)
PROTECTED Rojo Directorios del sistema, binarios principales y archivos críticos del SO (no se pueden sobrescribir)

Funciones avanzadas de Disk Cleaner (disk-sweeper)

Explore la ingeniería avanzada incorporada en esta habilidad como parte del ecosistema Openclaw Skills:

  • Protección de rutas críticas codificada: Las reglas de exclusión permanente impiden que cualquier escaneo o eliminación toque los archivos del sistema en /System, /bin, /sbin, /usr/bin, /etc y /dev.
  • Detección de duplicados de múltiples pasadas: Evita cuellos de botella en el rendimiento en grandes unidades de medios verificando primero los tamaños de los archivos, comprobando a continuación solo el hash del encabezado del archivo y ejecutando un hash SHA-256 completo solo como paso final de verificación.
  • Protocolo de eliminación 'Papelera primero': Garantiza que las eliminaciones físicas se omitan por defecto; en su lugar, los comandos nativos del sistema operativo mueven los archivos a la papelera del usuario (usando 'use_trash: true').
  • Manejo de interrupciones elegante: Captura las interrupciones SIGINT (Ctrl+C) para guardar instantáneamente el progreso, cesar los procesos activos y generar un registro estructurado de las operaciones completadas.
  • Arquitectura de red cero: Funciona totalmente de forma local, sin leer el contenido de los archivos y enviando cero paquetes de datos a través de Internet, manteniendo seguros los perfiles de uso de su sistema.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*