← Back to Skills Marketplace
315
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install fishaudio-tts
Description
Text-to-Speech using FishAudio (fish.audio), generates natural human-like voice with great emotional expression.
README (SKILL.md)
FishAudio TTS 🔊
High-quality text-to-speech using FishAudio (fish.audio), generates natural human-like voice with excellent emotional expression.
Features
- More natural and realistic voice than default TTS
- Better emotional expression for news reading
- Supports multiple voices
- Outputs MP3 format directly
Requirements
- Python 3.8+
- requests library
- FishAudio API key (get from https://fish.audio/)
Installation
- Get your API key from https://fish.audio/
- Add API key to your
TOOLS.mdor environment variableFISH_AUDIO_API_KEY pip install requests(usually already installed)
Usage
Basic Text to Speech
python C:\path o\skills\fishaudio-tts\fish_tts.py ^
--text "Your text here" ^
--output "output.mp3" ^
--voice "female"
Available Voices
female- Default female voice (good for news)male- Male voiceneutral- Neutral voice
Command Line Example
python ~/.openclaw/workspace/skills/fishaudio-tts/fish_tts.py ^
--text "各位听众好，这里是2026年3月11日新闻简报。" ^
--output "C:\Users\hyzu\Documents\openclaw\
ews_audio.mp3" ^
--voice "female"
Notes
- API key is required, get one for free at https://fish.audio/
- Free tier has rate limits, check FishAudio website for details
- For news video generation, female voice is recommended for better listening experience
- All generated audio files are saved locally on your machine
Usage Guidance
This skill appears to be a straightforward FishAudio TTS client, but be aware of two issues before using it: (1) the registry metadata does NOT declare that the script needs an API key, yet the code requires FISH_AUDIO_API_KEY (or will try to extract one from ~/.openclaw/workspace/TOOLS.md). (2) the script reads that specific TOOLS.md file (and checks it for a proxy string), which could contain other secrets you didn't intend to expose. Recommendations: inspect the fish_tts.py source yourself (it is included) and only run it if you trust it; prefer setting the API key via an environment variable rather than storing it in TOOLS.md; verify that ~/.openclaw/workspace/TOOLS.md doesn't contain any other sensitive tokens before allowing the skill to read it; run the script in an isolated environment or sandbox and monitor network requests to ensure it calls the expected https://api.fish.audio endpoint. If you are uncomfortable with undeclared file access, ask the publisher to update the metadata to declare the required env var and config path (or remove implicit TOOLS.md parsing).
Capability Analysis
Type: OpenClaw Skill
Name: fishaudio-tts
Version: 1.0.1
The skill provides text-to-speech functionality using the FishAudio API. It follows its stated purpose, reading the API key from environment variables or a local configuration file (TOOLS.md) and making standard HTTPS requests to the official fish.audio endpoint. No evidence of malicious intent, data exfiltration, or unauthorized execution was found in fish_tts.py or SKILL.md.
Capability Assessment
Purpose & Capability
The description is a FishAudio TTS client, which is coherent with the included Python script. However the registry metadata declares no required environment variables or config paths while the code clearly needs a FishAudio API key (FISH_AUDIO_API_KEY) and also attempts to read ~/.openclaw/workspace/TOOLS.md for an API key. That mismatch (undisclosed credential requirement and file access) is disproportionate to the claimed metadata.
Instruction Scope
SKILL.md tells users to put their API key in an env var or TOOLS.md, but the runtime instructions in the included script explicitly read ~/.openclaw/workspace/TOOLS.md (searching for 'fish'/'api'/'key') and also looks for a specific local proxy string (127.0.0.1:7890). Reading a user workspace file was not declared in metadata and expands the scope of data the skill touches; while the code only parses for a key/proxy, it still reads an undeclared local file.
Install Mechanism
No install spec; this is an instruction-only skill with a single Python script that uses the widely used requests library. There are no remote downloads or archives, and the SKILL.md suggests 'pip install requests' only. Install risk is low.
Credentials
The skill actually requires an API key (FISH_AUDIO_API_KEY) even though the registry lists none. It also reads a local TOOLS.md for the key and proxy configuration. Requiring access to an undeclared user file and a secret is disproportionate to what the metadata claims and should be explicitly declared. The script does not request unrelated cloud creds, but the missing declaration and file read are notable.
Persistence & Privilege
The skill does not request 'always' presence and does not modify other skills or system-wide settings. It writes generated audio files to user-specified paths (expected behavior) and has no special persistence or elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install fishaudio-tts - After installation, invoke the skill by name or use
/fishaudio-tts - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Initial release of fishaudio-tts.
- Provides high-quality text-to-speech conversion using FishAudio API.
- Generates natural, emotionally expressive human-like voices.
- Supports multiple voice options (female, male, neutral).
- Outputs directly to MP3 format.
- Easy setup with API key and Python requirements.
Metadata
Frequently Asked Questions
What is fishaudio-tts?
Text-to-Speech using FishAudio (fish.audio), generates natural human-like voice with great emotional expression. It is an AI Agent Skill for Claude Code / OpenClaw, with 315 downloads so far.
How do I install fishaudio-tts?
Run "/install fishaudio-tts" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is fishaudio-tts free?
Yes, fishaudio-tts is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does fishaudio-tts support?
fishaudio-tts is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created fishaudio-tts?
It is built and maintained by zorro (@izorro); the current version is v1.0.1.
More Skills