A versatile CLI tool for integrating high-quality speech-to-text and text-to-speech capabilities via the OpenRouter API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openrouter-audio
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 openrouter-audio 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 OpenRouter Audio?
OpenRouter Audio is a specialized tool designed to empower AI agents with advanced auditory capabilities. By leveraging the OpenRouter API, it provides a unified interface for transcribing audio files into accurate text and generating natural-sounding speech from text prompts. This skill is a vital part of the Openclaw Skills collection, allowing developers to build interactive, voice-enabled applications with ease.
The skill is particularly effective for multi-language support, offering superior performance compared to standard system text-to-speech engines. Whether you are processing existing recordings or generating new audio content on the fly, this tool handles the heavy lifting of audio processing and model interaction.
OpenRouter Audio Use Cases
- Converting voice recordings and meeting notes into searchable text transcripts.
- Generating high-quality audio responses for AI-driven voice assistants.
- Creating summaries of audio files by passing custom prompts during the transcription process.
- Facilitating cross-language communication by generating speech in various accents and languages.
How OpenRouter Audio Works
- The user provides an audio file for transcription or a text string for speech generation.
- The skill validates the environment for the required API key and necessary binary dependencies.
- For transcription, the tool sends the audio data to the OpenRouter API using the openrouter/auto model by default.
- For generation, the tool utilizes models like openai/gpt-audio-mini to produce high-fidelity audio files.
- Transcription results are returned directly to the console, while generated audio files are saved to the workspace temporary directory for immediate use.
OpenRouter Audio Setup
To use this tool within your Openclaw Skills workflow, ensure you have Node.js installed and your API key configured.
# Set your OpenRouter API key
export OPENROUTER_API_KEY='your_api_key_here'
# Verify the installation and see available options
./openrouter-audio.sh --help
OpenRouter Audio Data Schema & Taxonomy
The skill produces structured data outputs to ensure compatibility with automated workflows. Generated audio is stored in temporary directories to maintain a clean workspace.
| Output Type | Data Format | Destination |
|---|---|---|
| Transcription | Plain Text | stdout |
| Generation Metadata | JSON Object | stdout |
| Audio Assets | MP3/WAV Files | {WORKSPACE_DIR}/tmp |
The generation JSON response includes the following fields:
- paths: A list of locations where the audio files are stored.
- transcript: The text content used for generation.
- format: The specific file format of the output.
OpenRouter Audio Advanced Features
- Intelligent workspace detection that automatically routes file outputs to the correct temporary directories.
- Custom prompt capabilities allowing users to ask questions about audio files during transcription.
- Support for a wide range of audio models and formats, including gpt-audio-mini and the alloy voice.
- Priority routing for non-English speech generation to ensure the highest quality output within the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
X (Twitter) API Integration
A zero-dependency Python CLI tool for interacting with X (Twitter) API v2 to manage profiles, timelines, search, and posting.
Withings Family Health Tracker
A multi-user Python skill to fetch comprehensive Withings health metrics including weight, body composition, activity, and sleep data.
WHO Growth Charts
A technical utility for generating standardized WHO growth charts with percentile curves and custom child data overlays.
WHO Growth Charts
A specialized AI skill for generating professional-grade WHO child growth standards charts with custom measurement overlays and percentile curves.
RSS Digest
An agentic feed digest tool that leverages the feed CLI to fetch, triage, and summarize high-signal RSS, Atom, and JSON posts.
RSS Digest
An agentic workflow that leverages the feed CLI to fetch, filter, and summarize the most important posts from your RSS subscriptions.
Featured*
