# Send speech-recognition to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "speech-recognition", "name": "speech-recognition", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/demo112/speech-recognition", "canonicalUrl": "https://clawhub.ai/demo112/speech-recognition", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/speech-recognition", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=speech-recognition", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "skill.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "speech-recognition", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-12T16:46:06.229Z", "expiresAt": "2026-05-19T16:46:06.229Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=speech-recognition", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=speech-recognition", "contentDisposition": "attachment; filename=\"speech-recognition-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "speech-recognition" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/speech-recognition" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/speech-recognition", "downloadUrl": "https://openagent3.xyz/downloads/speech-recognition", "agentUrl": "https://openagent3.xyz/skills/speech-recognition/agent", "manifestUrl": "https://openagent3.xyz/skills/speech-recognition/agent.json", "briefUrl": "https://openagent3.xyz/skills/speech-recognition/agent.md" } } ``` ## Documentation ### 通用语音识别 使用硅基流动 SenseVoice API 进行语音识别，支持多种音频格式。 ### 激活条件 触发场景说明用户发送语音消息.ogg / .mp3 / .wav / .m4a 文件用户要求转录音频"转录这个音频"、"语音转文字"音频文件处理需要提取音频中的文字内容 ### API Key 在 ~/.openclaw/openclaw.json 中配置： { "providers": { "siliconflow": { "apiKey": "sk-xxx" } } } ### API 端点 POST https://api.siliconflow.cn/v1/audio/transcriptions ### 支持的模型 模型说明FunAudioLLM/SenseVoiceSmall默认，中文效果好 ### 方法一：直接调用 API 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 分钟 语言支持：中文效果最好，英文也支持 隐私：音频会上传到硅基流动服务器 ### 相关 Skills Skill说明douyin-video抖音视频语音提取cosyvoice-tts文字转语音 版本：1.0.0 创建于：2026-02-26 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: demo112 - Version: 1.0.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-12T16:46:06.229Z - Expires at: 2026-05-19T16:46:06.229Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/speech-recognition) - [Send to Agent page](https://openagent3.xyz/skills/speech-recognition/agent) - [JSON manifest](https://openagent3.xyz/skills/speech-recognition/agent.json) - [Markdown brief](https://openagent3.xyz/skills/speech-recognition/agent.md) - [Download page](https://openagent3.xyz/downloads/speech-recognition)