القائمة
Speech recognition from voice messages. Use when you need to convert a voice message to text.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/johnalbertini14-glitch/openclaw-skills --skill sergei-mikhailov-sttيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Use this skill to create a Polymarket wallet for your agent and trade on prediction markets. Browse markets, place bets, manage positions — all without exposing private keys.
ClawSec suite manager with embedded advisory-feed monitoring, cryptographic signature verification, approval-gated malicious-skill response, and guided setup for additional security skills.
Automated daily security audits for OpenClaw agents with email reporting. Runs deep audits and sends formatted reports.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | sergei-mikhailov-stt |
| description | Speech recognition from voice messages. Use when you need to convert a voice message to text. |
| metadata | {"openclaw":{"requires":{"bins":["ffmpeg","python3"],"env":["YANDEX_API_KEY","YANDEX_FOLDER_ID"]},"primaryEnv":"YANDEX_API_KEY"}} |
This skill recognizes speech from voice messages sent via any messenger connected to OpenClaw, using various STT providers, including Yandex SpeechKit.
Use this skill when:
Example path from OpenClaw:
/home/user_folder/.openclaw/media/inbound/file_1---9a53bac2-0392-41e7-8300-1c08e8eec027.ogg
clawhub install sergei-mikhailov-stt
The skill will be placed at ~/.openclaw/workspace/skills/sergei-mikhailov-stt/.
Navigate to the installed skill folder and install dependencies into a virtual environment:
cd ~/.openclaw/workspace/skills/sergei-mikhailov-stt
On Debian/Ubuntu, first install the venv package if not already present:
sudo apt install python3-venv
Then create and activate the virtual environment:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
On modern Debian/Ubuntu systems (Python 3.12+), installing packages system-wide is restricted. Use the virtual environment as shown above.
Add credentials to ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"sergei-mikhailov-stt": {
"env": {
"YANDEX_API_KEY": "your_api_key_here",
"YANDEX_FOLDER_ID": "your_folder_id_here"
}
}
}
}
}
.env fileCopy and edit the example file inside the skill folder:
cp assets/.env.example .env
YANDEX_API_KEY=your_api_key_here
YANDEX_FOLDER_ID=your_folder_id_here
STT_DEFAULT_PROVIDER=yandex
openclaw gateway stop && openclaw gateway start
In config.json, set parameters for each provider:
{
"default_provider": "yandex",
"providers": {
"yandex": {
"api_key": "${YANDEX_API_KEY}",
"folder_id": "${YANDEX_FOLDER_ID}",
"lang": "ru-RU"
}
}
}
# scripts/providers/new_provider.py
from .base_provider import BaseSTTProvider
class NewProvider(BaseSTTProvider):
name = "new_provider"
def recognize(self, audio_file_path: str, language: str = 'ru-RU') -> str:
# Recognition implementation
pass
def validate_config(self, config: dict) -> bool:
# Configuration validation
pass
def get_supported_formats(self) -> list:
return ['ogg', 'wav', 'mp3']
Add to scripts/stt_processor.py in the _get_provider method:
if provider_name == 'new_provider':
return NewProvider(provider_config)
Add the new provider section to config.json:
{
"providers": {
"new_provider": {
"api_key": "${NEW_PROVIDER_API_KEY}",
"model": "latest"
}
}
}
User: [sends a voice message]
OpenClaw: Recognized text: "Hello, how are you?"
User: Transcribe this English voice message
OpenClaw: Recognized text (en-US): "Hello, how are you today?"
User: Analyze this voice message
OpenClaw: Recognized text: "Meeting tomorrow at 3 PM"
Language: ru-RU
Confidence: 95%
Provider: Yandex SpeechKit
When the skill returns an error, explain it to the user in plain language and suggest a concrete next step. Do not show raw error messages or stack traces.
| Error | Say to the user | Next step |
|---|---|---|
File too large | "The voice message is too long — maximum is about 30 seconds for now." | Ask them to send a shorter message |
Unsupported format | "This audio format is not supported." | Tell them supported formats: OGG, WAV, MP3, M4A, FLAC, AAC |
API key invalid / HTTP 401 | "There's a problem with the Yandex SpeechKit API key." | Ask owner to check YANDEX_API_KEY in openclaw.json |
Folder access denied / HTTP 403 | "Access to Yandex SpeechKit is denied." | Ask owner to verify the service account has ai.speechkit.user role |
Too many requests / HTTP 429 | "Yandex SpeechKit is rate-limiting us right now." | Try again in a few seconds |
FFmpeg not found | "Audio conversion tool (FFmpeg) is not installed on the server." | Owner needs to run brew install ffmpeg or apt install ffmpeg |
API request timed out | "Yandex SpeechKit did not respond in time." | Try again; if it repeats, the service may be down |
Missing YANDEX_API_KEY | "The skill is not configured yet — API keys are missing." | Owner needs to add keys to ~/.openclaw/openclaw.json |
~/.openclaw/openclaw.jsonffmpeg -versionai.speechkit.useropenclaw logsOn successful recognition:
{
"text": "Recognized text",
"language": "ru-RU",
"confidence": 0.95,
"provider": "yandex",
"processing_time": 2.5
}