Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
通用语音识别 Skill。支持多种音频格式(ogg/mp3/wav/m4a),使用硅基流动 SenseVoice API 进行语音转文字。当用户发送语音消息、音频文件,或需要转录音频时触发。
通用语音识别 Skill。支持多种音频格式(ogg/mp3/wav/m4a),使用硅基流动 SenseVoice API 进行语音转文字。当用户发送语音消息、音频文件,或需要转录音频时触发。
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
使用硅基流动 SenseVoice API 进行语音识别,支持多种音频格式。
触发场景说明用户发送语音消息.ogg / .mp3 / .wav / .m4a 文件用户要求转录音频"转录这个音频"、"语音转文字"音频文件处理需要提取音频中的文字内容
在 ~/.openclaw/openclaw.json 中配置: { "providers": { "siliconflow": { "apiKey": "sk-xxx" } } }
POST https://api.siliconflow.cn/v1/audio/transcriptions
模型说明FunAudioLLM/SenseVoiceSmall默认,中文效果好
import requests api_key = "sk-xxx" with open("/path/to/audio.mp3", "rb") as f: audio_data = f.read() response = requests.post( "https://api.siliconflow.cn/v1/audio/transcriptions", headers={"Authorization": f"Bearer {api_key}"}, files={"file": ("audio.mp3", audio_data, "audio/mpeg")}, data={"model": "FunAudioLLM/SenseVoiceSmall"}, timeout=60 ) print(response.json().get("text", ""))
当用户发送 .ogg 语音消息时: # 1. 转换格式(如果是 ogg) ffmpeg -i /path/to/audio.ogg -ar 16000 -ac 1 /tmp/audio.mp3 -y # 2. 调用硅基流动 API(API Key 从环境变量读取) python3 -c " import requests import os api_key = os.environ.get('SILICONFLOW_API_KEY') if not api_key: raise ValueError('请设置 SILICONFLOW_API_KEY 环境变量') with open('/tmp/audio.mp3', 'rb') as f: audio_data = f.read() response = requests.post( 'https://api.siliconflow.cn/v1/audio/transcriptions', headers={'Authorization': f'Bearer {api_key}'}, files={'file': ('audio.mp3', audio_data, 'audio/mpeg')}, data={'model': 'FunAudioLLM/SenseVoiceSmall'}, timeout=60 ) print(response.json().get('text', '')) "
格式扩展名说明MP3.mp3推荐,兼容性好OGG.oggTelegram/Signal 语音格式,需转换WAV.wav无压缩,文件大M4A.m4aiOS 录音格式FLAC.flac无损压缩
如果音频不是 MP3 格式,用 FFmpeg 转换: # OGG → MP3 ffmpeg -i input.ogg -ar 16000 -ac 1 output.mp3 -y # WAV → MP3 ffmpeg -i input.wav -ar 16000 -ac 1 output.mp3 -y # M4A → MP3 ffmpeg -i input.m4a -ar 16000 -ac 1 output.mp3 -y 参数说明: -ar 16000: 采样率 16kHz(语音识别推荐) -ac 1: 单声道(减少文件大小) -y: 覆盖已存在的文件
错误原因解决401 UnauthorizedAPI Key 无效检查配置413 Payload Too Large文件太大压缩或分割音频timeout网络超时重试或检查网络Invalid audio format格式不支持用 FFmpeg 转换
文件大小限制:建议 < 10MB 时长限制:建议 < 5 分钟 语言支持:中文效果最好,英文也支持 隐私:音频会上传到硅基流动服务器
Skill说明douyin-video抖音视频语音提取cosyvoice-tts文字转语音 版本:1.0.0 创建于:2026-02-26
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.