Openclaw용 Disk Cleaner (disk-sweeper)

Disk Cleaner는 디스크 사용량을 안전하게 분석하고, 대용량 파일을 식별하며, SHA-256 해싱을 통해 중복 항목을 탐지하고, 애플리케이션 캐시를 안전하게 정리하도록 설계된 지능형 명령줄 도구입니다.

harrylabsj
v1.0.0
Jun 14, 2026
0
568
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install disk-sweeper

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 disk-sweeper 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Disk Cleaner (disk-sweeper)란 무엇인가요?

Disk Cleaner (disk-sweeper)는 Openclaw Skills를 통해 제공되는 고성능 시스템 분석 및 정리 유틸리티입니다. 개발자와 파워 유저를 위해 설계된 이 CLI 도구는 재귀적 디렉토리 스캔을 실행하여 파일 유형, 크기 및 생성 날짜별로 스토리지 분포를 분류합니다. 이 도구의 독특한 점은 엄격한 안전 가이드라인입니다. 시스템 중요 디렉토리를 보호하며 다단계 안전 등급 프레임워크를 사용하여 필수 파일을 삭제하지 않도록 보장합니다.

기본 정리 외에도 이 도구는 macOS 캐시, Xcode, Docker, node_modules 및 주요 중국 생산성 도구(WeChat, DingTalk, QQ, Baidu, WPS)와 같은 리소스를 많이 점유하는 앱 캐시를 심층적으로 탐지하는 데 탁월합니다. 완전히 오프라인으로 실행되어 네트워크 노출이 없으며, 스마트한 다중 패스 SHA-256 중복 제거 알고리즘을 활용하여 중복 파일로 인해 낭비되는 공간을 찾아내고 확보합니다.

Disk Cleaner (disk-sweeper) 활용 사례

Openclaw Skills 디렉토리에서 이 유틸리티를 활용하는 일반적인 방법은 다음과 같습니다:

  • 개발자 스토리지 확보: Docker 이미지, Xcode DerivedData, npm/yarn node_modules 및 Homebrew 패키지에서 쌓인 무거운 캐시를 즉시 스캔하고 삭제합니다.
  • 앱 캐시 정리: 채팅 기록을 방해하지 않고 WeChat, DingTalk, QQ와 같은 커뮤니케이션 도구가 생성한 방대한 캐시 디렉토리를 식별하고 안전하게 삭제합니다.
  • 시스템 공간 감사: 홈 디렉토리 전체에서 실시간 스트리밍 스캔을 실행하여 대용량 파일 및 전체 디스크 사용량에 대한 명확한 시각적 보고서를 출력합니다.
  • 중복 파일 탐지: 크기 기반 정렬 및 계층적 SHA-256 콘텐츠 해싱을 사용하여 정확한 중복 파일을 그룹화하고 탐지함으로써 아카이브와 미디어를 안전하게 정리합니다.
  • 자동 유지 관리: 매주 예약된 스캔 cron 작업을 설정하여 디스크 상태를 추적하고 모니터링을 위한 구조화된 JSON 요약을 출력합니다.

Disk Cleaner (disk-sweeper) 작동 원리

이 도구는 Openclaw Skills를 통해 트리거될 때 다음과 같은 구조화된 5단계 실행 파이프라인을 따릅니다:

  1. 스트리밍 파일 시스템 스캔: scanner.py 엔진은 비동기적으로 대상 경로를 스캔하며 시스템 보호 디렉토리와 액세스 권한이 없는 디렉토리를 자동으로 건너뜁니다.
  2. 다차원 집계: analyzer.py 엔진은 파일을 실시간으로 처리하여 유형, 크기, 디렉토리 깊이, 확장자 및 파일 연령별로 그룹화합니다.
  3. 중복 제거 확인: 중복 탐지를 위해 이 도구는 먼저 크기별로 잠재적 일치 항목을 그룹화한 다음 헤드 해시를 분석하고, 전체 SHA-256 콘텐츠 해시를 완료하여 오버헤드 없이 완벽한 일치를 보장합니다.
  4. 안전 등급 분석: 안전 엔진은 하드코딩된 보호 매트릭스와 패턴에 대해 경로를 평가하여 색상 코드로 구분된 위험 등급(안전, 정리 가능, 주의, 보호됨)으로 파일을 태그합니다.
  5. 안전한 실행: 기본적으로 미리보기를 수행합니다. 확인 후 파일은 영구 삭제 대신 시스템 휴지통으로 안전하게 이동되어(네이티브 API 사용) 즉각적인 안전망을 제공합니다.

Disk Cleaner (disk-sweeper) 설정 가이드

Openclaw Skills의 레지스트리에서 직접 Disk Cleaner를 시작하세요:

# disk-sweeper 스킬을 전역으로 설치
clawhub install disk-sweeper

# 홈 디렉토리의 빠르고 안전한 스캔 실행
clawhub run disk-sweeper scan --paths ~/

# 아무것도 삭제하지 않고 정리 가능한 항목을 안전하게 미리보기
clawhub run disk-sweeper clean --mode preview

# 녹색(안전)으로 표시된 항목에 대해 자동 정리 안전하게 실행
clawhub run disk-sweeper clean --mode auto-safe --confirm

Disk Cleaner (disk-sweeper) 데이터 스키마 및 분류 체계

Disk Cleaner 스킬은 파일 시스템 작업, 분석 및 규칙 정의를 분리하기 위해 모듈식으로 구조화되어 있습니다. 다음은 Openclaw Skills의 이 항목에서 사용된 프로젝트 파일 아키텍처 및 메타데이터 schema입니다:

프로젝트 디렉토리 구조

disk-sweeper/
├── SKILL.md                 # 스킬 정의 및 문서
├── scripts/
│   ├── scanner.py           # 파일 시스템 스캐너 (스트리밍 + 진행률)
│   ├── analyzer.py          # 공간 분석 엔진
│   ├── duplicates.py        # 중복 파일 탐지 (SHA-256)
│   ├── caches.py            # 앱 캐시 인식
│   ├── safety.py            # 안전 등급 + 보호 목록
│   ├── cleaner.py           # 정리 실행기 (휴지통/삭제/실행 취소)
│   ├── formatter.py         # 보고서 서식 지정
│   └── progress.py          # 진행률 표시줄 + 상태 출력
└── references/
    ├── protected-paths.json # 시스템 경로 보호 정의
    ├── cache-patterns.json  # 애플리케이션 캐시 정규식 및 경로
    └── file-types.json      # 확장자-카테고리 매핑

안전 등급 매트릭스

등급 색상 표시 근거 / 작업
SAFE 녹색 안전하게 삭제 가능한 재구성 가능한 캐시 (예: npm, pip)
CLEANABLE 노란색 사용하지 않는 개발 자산 (예: Xcode DerivedData, Docker 이미지)
CAUTION 주황색 사용자 데이터나 첨부 파일이 포함된 앱 캐시 (예: WeChat, QQ)
PROTECTED 빨간색 시스템 디렉토리, 핵심 바이너리 및 OS 중요 파일 (덮어쓰기 불가)

Disk Cleaner (disk-sweeper) 고급 기능

Openclaw Skills 생태계의 일부로 이 스킬에 내장된 고급 엔지니어링 기능을 살펴보세요:

  • 하드코딩된 중요 경로 보호: 영구 제외 규칙은 /System, /bin, /sbin, /usr/bin, /etc 및 /dev의 시스템 파일을 스캔하거나 삭제하지 못하도록 방지합니다.
  • 다중 패스 중복 탐지: 파일 크기를 먼저 확인하고, 다음으로 파일 헤더 해시만 검사하며, 마지막 검증 단계에서만 전체 SHA-256 해시를 실행하여 대형 미디어 드라이브에서의 성능 병목 현상을 방지합니다.
  • 휴지통 우선 삭제 프로토콜: 기본적으로 물리적 삭제를 건너뛰도록 보장합니다. 대신 네이티브 운영 체제 명령이 파일을 사용자의 휴지통으로 이동시킵니다('use_trash: true' 사용).
  • 우아한 인터럽트 처리: SIGINT (Ctrl+C) 인터럽트를 캡처하여 진행 상황을 즉시 저장하고, 활성 프로세스를 중단하며, 완료된 작업의 구조화된 로그를 출력합니다.
  • 제로 네트워크 아키텍처: 완전히 로컬에서 작동하며, 파일 내용을 읽지 않고 인터넷을 통해 데이터 패킷을 전혀 보내지 않아 시스템 사용 프로필을 안전하게 유지합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*