← Back to Skills Marketplace
364
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install aiml-voice
Description
Transcribe audio files (ogg, mp3, wav, etc.) using AIMLAPI. Use when the user provides audio messages or local audio files. Provides a reliable Python script...
README (SKILL.md)
AIMLAPI Voice Transcription
Overview
A robust skill for transcribing audio via AIMLAPI's specialized speech-to-text endpoints. It handles queuing, polling for results, and automatic MIME-type detection.
Quick Start
# Set your API key first (if not in env)
# export AIMLAPI_API_KEY="your-key-here"
# Transcribe a file
python {baseDir}/scripts/transcribe.py path/to/audio.ogg
Tasks
Process Voice Messages
When an audio file is received, use this script to extract the text.
python {baseDir}/scripts/transcribe.py \x3Cfile_path> \
--model "#g1_whisper-medium" \
--verbose
Arguments
file: (Required) Path to the audio file.--model: Model ID (default:#g1_whisper-medium).--out: Path to save the transcript text.--poll-interval: Seconds between status checks (default: 5).--max-wait: Stop waiting after N seconds (default: 300).
Dependencies
- Python 3
AIMLAPI_API_KEYset in environment or provided via--apikey-file.
Usage Guidance
This skill appears to do what it claims: it uploads a local audio file to https://api.aimlapi.com for transcription and returns the transcript. Before installing, verify you trust the AIMLAPI service and the key you will provide (the API key can be used for billing and data access). Note the source/publisher is unknown and there is no homepage — if you require strong provenance, request a trustworthy publisher or review provenance. Also be aware the script reads the entire audio file into memory (no size checks), so avoid processing very large files or sensitive recordings until you confirm the service's privacy policy. Test with non-sensitive audio first and keep your AIMLAPI_API_KEY secret.
Capability Analysis
Type: OpenClaw Skill
Name: aiml-voice
Version: 1.0.0
The skill is designed for transcribing audio files using the AIMLAPI service. The `SKILL.md` provides clear, non-malicious instructions for the AI agent, specifying the use of the `transcribe.py` script with relevant arguments. The `transcribe.py` script correctly implements this functionality, handling API keys from environment variables or a specified file, performing network requests only to the hardcoded `api.aimlapi.com` endpoint, and processing local audio files. There is no evidence of intentional harmful behavior such as data exfiltration, unauthorized command execution, persistence mechanisms, or prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
Name/description match the included script and declared env var: the tool uploads audio to AIMLAPI STT endpoints and polls for results. Requiring AIMLAPI_API_KEY and python is proportional.
Instruction Scope
SKILL.md tells the agent to run the provided transcribe.py script and mentions only the API key and usual args. The instructions do not request unrelated files, extra credentials, or external endpoints beyond the AIMLAPI API.
Install Mechanism
No install spec is present (instruction-only plus a bundled script). The script uses only Python standard libraries and no external downloads, so there is no high-risk installer activity.
Credentials
Only AIMLAPI_API_KEY is required, which is appropriate for a third-party STT service. Note: the API key grants access to your AIMLAPI account and usage/billing, so treat it like a secret and only provide a key you trust the service with.
Persistence & Privilege
always is false and the skill does not request persistent system-level configuration or modify other skills. It does not ask to run continuously or store credentials beyond reading env or an explicit apikey file.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install aiml-voice - After installation, invoke the skill by name or use
/aiml-voice - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of AIMLAPI audio transcription skill.
- Transcribes audio files (ogg, mp3, wav, etc.) using AIMLAPI's speech-to-text endpoints.
- Supports robust queuing, polling for results, and automatic MIME-type detection.
- CLI script for submitting, tracking, and saving transcription output.
- Requires AIMLAPI_API_KEY.
- Adjustable model, polling interval, and timeout options.
Metadata
Frequently Asked Questions
What is AIML Voice Transcript?
Transcribe audio files (ogg, mp3, wav, etc.) using AIMLAPI. Use when the user provides audio messages or local audio files. Provides a reliable Python script... It is an AI Agent Skill for Claude Code / OpenClaw, with 364 downloads so far.
How do I install AIML Voice Transcript?
Run "/install aiml-voice" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AIML Voice Transcript free?
Yes, AIML Voice Transcript is completely free (open-source). You can download, install and use it at no cost.
Which platforms does AIML Voice Transcript support?
AIML Voice Transcript is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AIML Voice Transcript?
It is built and maintained by AI/ML API (@aimlapihello); the current version is v1.0.0.
More Skills