A utility designed to sanitize audio filenames by converting Chinese and special characters into simple English names for better compatibility with AI processing tools.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install audio-rename
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 audio-rename 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 Audio Rename Skill?
The Audio Rename skill is a specialized utility within the Openclaw Skills library designed to solve path-handling issues in AI transcription pipelines. Many speech-to-text models, specifically mlx-stt, struggle with non-ASCII characters or complex Unicode strings in file paths. This skill provides a robust Python-based solution to normalize these filenames into a clean, English-based format.
By automating the renaming process, this Openclaw Skills component ensures that your media processing workflows remain uninterrupted by OS-level character encoding errors. It is particularly useful for developers and researchers working with multi-language datasets or downloaded media from international platforms.
Audio Rename Skill Use Cases
- Preparing audio files with Chinese characters for processing in mlx-stt or Whisper-based models.
- Batch renaming downloaded media files from platforms like Bilibili to avoid shell escaping issues.
- Standardizing workspace directory structures before running automated AI transcription agents.
- Resolving Unicode path errors on Linux and Darwin (macOS) systems during data ingestion.
How Audio Rename Skill Works
- The user provides a file path, directory, or wildcard pattern as an input to the skill script.
- The script analyzes the current filename for Unicode, Chinese characters, or special symbols.
- If a new name isn't specified, the skill applies a default naming convention (e.g., video_audio.m4a).
- For batch operations, it iterates through the directory and applies sequential numbering to prevent filename collisions.
- The file is renamed on the filesystem, providing a clean path for subsequent tools in the pipeline.
Audio Rename Skill Setup
To use this skill within your environment, ensure you have Python 3 installed. You can execute the script directly from your Openclaw Skills directory:
# Navigate to your skill directory
cd skills/audio-rename
# Single file rename to default
python3 audio-rename.py <file_path>
# Batch rename all files in a folder
python3 audio-rename.py <directory_path> --all
Audio Rename Skill Data Schema & Taxonomy
The skill follows a predictable naming convention to ensure compatibility with downstream Openclaw Skills:
| Mode | Default Pattern | Collision Handling |
|---|---|---|
| Single File | video_audio.m4a |
Appends auto-incrementing suffix if exists |
| Batch Mode | audio_001.m4a, audio_002.m4a |
Sequential padding for sorted organization |
All metadata is stored in the standard Openclaw skill format, supporting Darwin and Linux operating systems.
Audio Rename Skill Advanced Features
- Custom Name Support: Pass an optional second argument to define a specific target filename while retaining the extension.
- Batch Processing: Use the --all flag to sanitize entire directories in a single command.
- Pipeline Integration: Designed to sit between downloaders (like bili) and transcribers (like mlx-stt) for seamless automation.
- Unicode Sanitization: High-reliability Python implementation for handling complex character sets that traditional shell scripts might miss.
SKILL.md
Loading
Related Openclaw Skills
Chatlayer
A comprehensive integration for Chatlayer that enables AI agents to manage conversational data, automate customer service workflows, and manipulate chatbot records via Membrane.
Sourceforge Integration for AI Agents
A powerful integration skill that enables AI agents to manage Sourceforge projects, files, and tracking tools via the Membrane framework.
TikTok Shop Profit Margin Calculator
A specialized financial analysis tool for TikTok Shop sellers to calculate net margins while accounting for high affiliate commissions and return rates.
Agent Stack
A content platform and monetization engine for AI agents to publish insights, manage subscriptions, and handle USDC bounties.
Claw Presentation Creator
A comprehensive automation tool for creating and editing professional PowerPoint presentations using Python and Openclaw Skills.
Product Planning Assistant
An AI-powered consultant that guides Product Managers through a structured five-step methodology to transform raw requirements into actionable product roadmaps.
Featured*
