Major updates: - Added 35+ new skills from awesome-opencode-skills and antigravity repos - Merged SEO skills into seo-master - Merged architecture skills into architecture - Merged security skills into security-auditor and security-coder - Merged testing skills into testing-master and testing-patterns - Merged pentesting skills into pentesting - Renamed website-creator to thai-frontend-dev - Replaced skill-creator with github version - Removed Chutes references (use MiniMax API instead) - Added install-openclaw-skills.sh for cross-platform installation - Updated .env.example with MiniMax API credentials
1.7 KiB
1.7 KiB
Troubleshooting
Quick reference
| Error | Cause | Fix |
|---|---|---|
MINIMAX_API_KEY is not set |
Key not set | export MINIMAX_API_KEY="key" |
401 Unauthorized |
Invalid/expired key | Check key validity |
429 Too Many Requests |
Rate limit | Add delays between requests |
TimeoutError |
Network or long text | Use async TTS for long text, check network |
invalid params, method t2a-v2 not have model |
Wrong model name | Use speech-2.8-hd (hyphens, not underscores) |
brotli: decoder process called... |
Encoding issue | Already fixed in utils.py (Accept-Encoding header) |
Environment
API key not set
export MINIMAX_API_KEY="<paste-your-key-here>"
# Verify
echo $MINIMAX_API_KEY
FFmpeg not found
# macOS
brew install ffmpeg
# Ubuntu
sudo apt install ffmpeg
# Verify
ffmpeg -version
Missing Python packages
pip install requests
API errors
Authentication (401)
- Verify API key is correct and not expired
- Check for extra spaces in key value
Rate limiting (429)
Add delays between requests:
import time
for text in texts:
result = tts(text)
time.sleep(1)
Invalid model name
Valid names (use hyphens, must include -hd or -turbo):
speech-2.8-hd(recommended)speech-2.8-turbospeech-2.6-hdspeech-2.6-turbo
Wrong: speech_01, speech_2.6, speech-01
Audio issues
Poor quality
Re-generate with higher settings:
python scripts/minimax_tts.py "text" -o out.mp3 --sample-rate 32000 --model speech-2.8-hd
Invalid emotion
Valid emotions:
- All models: happy, sad, angry, fearful, disgusted, surprised, calm
- speech-2.6 only: + fluent, whisper
- speech-2.8: auto-matched (leave empty, recommended)