File Manager — OpenClaw 自动化文件管理

File Manager — это автоматизированный помощник для управления файлами в OpenClaw, предназначенный для пакетных операций, интеллектуальной сортировки, удаления дубликатов, переименования файлов и синхронизации каталогов. Подходит для задач наведения порядка в файловой системе и автоматизации рабочих процессов.

Ключевые возможности

1. Интеллектуальная сортировка файлов (organize)

Автоматическая классификация файлов по типу, дате, размеру или пользовательским правилам.

# Сортировка по типу файлов
python scripts/organize.py  --by-type

# Сортировка по дате (год/месяц/день)
python scripts/organize.py  --by-date --date-format year/month

# Сортировка по размеру (в разработке)
# python scripts/organize.py  --by-size --size-ranges "10MB,100MB,1GB"

2. Пакетное переименование (batch_rename)

Поддержка регулярных выражений, нумерации, дат и других шаблонов для гибкого переименования файлов.

# Добавление префикса/суффикса
python scripts/batch_rename.py  --prefix "IMG_" --suffix "_2024"

# Замена по регулярному выражению
python scripts/batch_rename.py "*.jpg" --replace "IMG_(\d+)" "Photo_\1"

# Переименование с последовательной нумерацией
python scripts/batch_rename.py "*.jpg" --sequence --padding 4

3. Удаление дубликатов (deduplicate)

Обнаружение и обработка повторяющихся файлов на основе хэширования содержимого.

# Сканирование и вывод списка дубликатов
python scripts/deduplicate.py  --scan-only

# Удаление дубликатов (с сохранением самого старого/нового файла)
python scripts/deduplicate.py  --keep oldest --action delete

# Перемещение дубликатов в карантин
python scripts/deduplicate.py  --action move --to 

4. Синхронизация каталогов (sync)

Односторонняя или двусторонняя синхронизация директорий с поддержкой исключений и инкрементальных обновлений.

# Односторонняя синхронизация (источник → цель)
python scripts/sync.py   --mirror

# Двусторонняя синхронизация (в разработке)
python scripts/sync.py   --bidirectional

# Исключение определённых файлов
python scripts/sync.py   --exclude "*.tmp,*.log,.git"

Сценарии использования

Типичные кейсы

Сценарий 1: Организация папки загрузок

python scripts/organize.py ~/Downloads --by-type --move

Сценарий 2: Очистка дубликатов фотографий

python scripts/deduplicate.py ~/Pictures --scan-only

Сценарий 3: Упорядочивание проектных файлов

python scripts/organize.py ./projects --by-date --date-format year/month

Сценарий 4: Автоматическое резервное копирование

python scripts/sync.py ~/Work ~/Backups/Work --exclude "node_modules,.git,*.tmp"

Рабочие процессы

Процесс организации файлов

• Анализ структуры каталогов и распределения файлов
• Выбор стратегии сортировки (тип, дата, размер, пользовательские правила)
• Предпросмотр (dry-run) → подтверждение → выполнение
• Проверка результата

Процесс очистки

• Сканирование дубликатов, устаревших и крупных файлов
• Формирование отчёта и предварительный просмотр
• Подтверждение пользователем или автоматическая обработка
• Перемещение в корзину, карантин или удаление

Процесс синхронизации

• Анализ различий между источником и целевой директорией
• Предпросмотр списка изменений
• Подтверждение и запуск синхронизации
• Отображение статистики

Принципы безопасности

• Сначала предпросмотр: все операции по умолчанию выполняются в режиме dry-run, для применения нужен флаг --execute
• Подтверждение действий: перед выполнением требуется явное подтверждение пользователя
• Безопасность символических ссылок: при обходе директорий они игнорируются, чтобы избежать зацикливания
• Защита от конфликтов: существующие файлы не перезаписываются — происходит переименование или пропуск

Зависимости и окружение

Требования:

• Python 3.8 или выше
• Отсутствие внешних зависимостей — используется только стандартная библиотека Python

Параметры скриптов

Для получения подробной информации о параметрах используйте встроенную справку:

python scripts/