A comprehensive audio processing toolkit for AI agents to analyze, convert, and manipulate media files using industry-standard CLI tools.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install audio-handler
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-handler 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 Handler?
The Audio Handler skill is a robust integration designed for AI coding agents to manage a wide array of audio tasks. By leveraging the power of ffmpeg and ffprobe, this skill allows your agent to perform deep metadata analysis, format transcoding, and precise audio editing. This is a vital component of the Openclaw Skills ecosystem for developers building media-heavy applications or automated content pipelines.
Supporting formats from standard MP3 to specialized Opus and FLAC, the skill provides high-level control over audio properties. It handles everything from simple playback on macOS to complex multi-track mixing and loudness normalization, ensuring that your AI agent can function as a virtual audio engineer.
Audio Handler Use Cases
- Automating the conversion of high-resolution WAV files to compressed, web-ready formats like MP3 or AAC.
- Extracting technical metadata such as sample rates, bitrates, and durations for media auditing.
- Trimming long recordings into specific clips or merging multiple segments into a single cohesive file.
- Normalizing volume levels across diverse audio libraries to maintain consistent loudness.
- Generating voice-overs or notifications using macOS text-to-speech integration.
How Audio Handler Works
- The AI agent identifies a trigger, such as a mention of an audio file path or a specific request to process a media file.
- The skill executes ffprobe to gather technical specifications and metadata in a structured JSON format.
- Based on the user's requirements, the agent constructs and runs optimized ffmpeg commands for conversion, trimming, or filtering.
- For macOS users, the skill can utilize native utilities like afplay for playback or the say command for text-to-speech generation.
- The skill provides feedback to the agent, confirming the success of the operation and the location of any newly generated assets.
Audio Handler Setup
To use this skill within your Openclaw Skills configuration, ensure that ffmpeg is installed and available in your system path.
# For macOS users
brew install ffmpeg
# For Linux users
sudo apt update && sudo apt install ffmpeg
After installation, ensure the helper scripts have execution permissions:
chmod +x scripts/audio_info.sh scripts/convert_audio.sh scripts/trim_audio.sh scripts/normalize_audio.sh
Audio Handler Data Schema & Taxonomy
The Audio Handler organizes data through CLI tool outputs and standardized scripts. Below is the metadata and format taxonomy:
| Feature | Details |
|---|---|
| Supported Formats | MP3, WAV, FLAC, AAC, M4A, OGG, Opus, WMA, AIFF |
| Metadata Format | JSON via ffprobe (streams, duration, bitrate, sample rate) |
| Processing Hooks | Custom shell scripts for info, conversion, trimming, and normalization |
| TTS Output | AIFF (native) or converted MP3/AAC via ffmpeg pipeline |
Audio Handler Advanced Features
- Intelligent Loudness Normalization: Uses the loudnorm filter to ensure professional audio standards.
- Advanced Mixing: Ability to mix voice and background music tracks with duration matching.
- Precise Re-encoding: Accurate trimming that avoids the sync issues often found in simple stream copying.
- Multi-format Transcoding: Optimized presets for music archives, podcasts, and low-bitrate voice memos.
- Background Playback: Non-blocking audio playback on macOS for status notifications.
SKILL.md
Loading
Related Openclaw Skills
Tencent Cloud Human Portrait Segmentation
A professional-grade portrait segmentation skill for AI agents to perform automatic image matting and contour recognition.
Tencent Cloud Image Face Fusion
A professional-grade face fusion skill that seamlessly merges user faces with template images using high-performance Tencent Cloud AI.
Tencent Cloud HunYuan AI Art Generator
A professional AI image generation skill leveraging the Tencent Cloud HunYuan large model for high-quality text-to-image and image-to-image synthesis.
Tencent Cloud Hunyuan 3D Generation
A high-performance AI skill to generate high-fidelity 3D models from text or image inputs using Tencent Cloud Hunyuan 3D technology.
Document Handler
A versatile utility for extracting text, metadata, and converting various document formats including PDF, Word, and Excel.
Image Handler
A comprehensive utility for reading, analyzing, and manipulating a wide variety of image formats using native macOS tools and ffmpeg.
Featured*
