FileClean is a utility that transforms messy, machine-generated filenames into human-readable formats by stripping timestamps, hashes, and symbols.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fileclean
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install fileclean using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is FileClean?
FileClean is a specialized utility designed to bring order to digital workspaces by sanitizing filename clutter. It intelligently identifies and removes common noise such as date timestamps, hexadecimal hashes, UUIDs, and excessive symbols that often plague automated exports or downloads. By integrating this tool into your workflow, you can ensure your filesystem remains organized and searchable.
As part of the broader Openclaw Skills ecosystem, FileClean provides developers and power users with a programmatic way to maintain clean naming conventions across large directories. It moves beyond simple regex by focusing on the semantic readability of your files, transforming a string like report_20230101_a1b2c3d.pdf into a crisp, professional Report.pdf.
FileClean Use Cases
- Cleaning up automated export folders where files are appended with unique identifiers.
- Standardizing naming conventions for media libraries or document archives.
- Preparing files for client-facing delivery by removing internal build hashes or timestamps.
- Batch processing download folders to remove redundant metadata from filenames.
How FileClean Works
- The skill scans the targeted file or directory provided in the command line argument.
- It parses the filenames to detect patterns matching UUIDs, ISO dates, Unix timestamps, and long alphanumeric hashes.
- A normalization algorithm removes these patterns and cleans up trailing underscores, hyphens, or whitespace.
- If run in preview mode, the skill outputs a diff of the proposed changes without modifying the disk.
- Upon receiving the rename flag, the skill executes the filesystem move operation to apply the new names.
FileClean Setup
To get started with this entry in the Openclaw Skills library, ensure you have Python installed and run the script directly from your terminal:
# Navigate to the tool directory
cd fileclean
# Run a preview on specific directories
python fileclean.py ~/Downloads ~/Documents --skip-ext pdf jpg
# Apply the renaming logic to a specific file
python fileclean.py myfile.txt --rename
FileClean Data Schema & Taxonomy
FileClean operates directly on the filesystem metadata. It analyzes the following components:
| Attribute | Description |
|---|---|
| Original Name | The source string including hashes and timestamps. |
| Target Name | The sanitized string after pattern removal and casing normalization. |
| Extension | Preserved or optionally skipped via the --skip-ext flag. |
| Path | The absolute or relative directory location of the target. |
FileClean Advanced Features
- Selective extension skipping to protect specific file types from renaming logic.
- Multi-directory batch processing in a single execution command.
- Dry-run preview mode to validate changes before altering the filesystem.
- Support for complex symbol stripping including double dashes and nested underscores.
SKILL.md
Loading
Related Openclaw Skills
Elementary Student
A realistic AI persona simulation of an elementary student with limited academic knowledge and high life skills for immersive roleplay.
Recipe Chef
An intelligent culinary agent that turns available ingredients, kitchen context, and dietary goals into actionable meal plans and optimized shopping lists.
Landing Page Builder
An AI-driven generator that creates stunning, high-fidelity landing pages with cinematic video backgrounds and automated online deployment.
I18nCheck
I18nCheck is a local-first scanner that detects internationalization anti-patterns, hardcoded UI strings, and localization readiness issues across multiple programming languages.
Reciprocity Strategy Designer
A strategic framework for applying the psychological principle of reciprocity to marketing, negotiation, and defensive social intelligence.
Liking Factor Engineer
A psychological engineering tool designed to analyze and implement the five core factors of likability to increase rapport, persuasion, and defensive awareness in any communication context.
Featured*
