Tools
تحويل النص إلى كلام
يمكن لـ OpenClaw تحويل الردود الصادرة إلى صوت عبر 14 مزودًا للكلام وتسليم رسائل صوتية أصلية على Feishu وMatrix وTelegram وWhatsApp، ومرفقات صوتية في كل مكان آخر، وتدفقات PCM/Ulaw للاتصالات الهاتفية وTalk.
TTS هو نصف إخراج الكلام في وضع stt-tts الخاص بـ Talk. جلسات Talk
realtime الأصلية لدى المزود تُنشئ الكلام داخل مزود الوقت الفعلي بدلًا
من استدعاء مسار TTS هذا، بينما لا تُنشئ جلسات transcription استجابة
صوتية للمساعد.
البدء السريع
Pick a provider
OpenAI وElevenLabs هما أكثر الخيارات المستضافة موثوقية. يعمل Microsoft و Local CLI دون مفتاح API. راجع مصفوفة المزودين للاطلاع على القائمة الكاملة.
Set the API key
صدّر متغير البيئة لمزودك (على سبيل المثال OPENAI_API_KEY،
ELEVENLABS_API_KEY). لا يحتاج Microsoft وLocal CLI إلى مفتاح.
Enable in config
اضبط messages.tts.auto: "always" وmessages.tts.provider:
{ messages: { tts: { auto: "always", provider: "elevenlabs", }, },}Try it in chat
يعرض /tts status الحالة الحالية. يرسل /tts audio Hello from OpenClaw
ردًا صوتيًا لمرة واحدة.
المزودون المدعومون
| المزود | المصادقة | ملاحظات |
|---|---|---|
| Azure Speech | AZURE_SPEECH_KEY + AZURE_SPEECH_REGION (أيضًا AZURE_SPEECH_API_KEY, SPEECH_KEY, SPEECH_REGION) |
إخراج ملاحظات صوتية Ogg/Opus أصلية واتصالات هاتفية. |
| DeepInfra | DEEPINFRA_API_KEY |
TTS متوافق مع OpenAI. الافتراضي هو hexgrad/Kokoro-82M. |
| ElevenLabs | ELEVENLABS_API_KEY أو XI_API_KEY |
استنساخ الصوت، متعدد اللغات، حتمي عبر seed؛ يُبث لتشغيل الصوت في Discord. |
| Google Gemini | GEMINI_API_KEY أو GOOGLE_API_KEY |
TTS دفعي عبر Gemini API؛ واعٍ بالشخصية عبر promptTemplate: "audio-profile-v1". |
| Gradium | GRADIUM_API_KEY |
إخراج ملاحظات صوتية واتصالات هاتفية. |
| Inworld | INWORLD_API_KEY |
Streaming TTS API. ملاحظات صوتية Opus أصلية واتصالات هاتفية PCM. |
| Local CLI | لا شيء | يشغّل أمر TTS محليًا مكوّنًا. |
| Microsoft | لا شيء | TTS عصبي عام من Edge عبر node-edge-tts. أفضل جهد، بلا SLA. |
| MiniMax | MINIMAX_API_KEY (أو خطة الرموز: MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) |
T2A v2 API. الافتراضي هو speech-2.8-hd. |
| OpenAI | OPENAI_API_KEY |
يُستخدم أيضًا للتلخيص التلقائي؛ يدعم instructions الخاصة بالشخصية. |
| OpenRouter | OPENROUTER_API_KEY (يمكنه إعادة استخدام models.providers.openrouter.apiKey) |
النموذج الافتراضي hexgrad/kokoro-82m. |
| Volcengine | VOLCENGINE_TTS_API_KEY أو BYTEPLUS_SEED_SPEECH_API_KEY (AppID/رمز قديم: VOLCENGINE_TTS_APPID/_TOKEN) |
BytePlus Seed Speech HTTP API. |
| Vydra | VYDRA_API_KEY |
مزود مشترك للصور والفيديو والكلام. |
| xAI | XAI_API_KEY |
TTS دفعي من xAI. الملاحظة الصوتية Opus الأصلية غير مدعومة. |
| Xiaomi MiMo | XIAOMI_API_KEY |
MiMo TTS عبر إكمالات محادثة Xiaomi. |
إذا تم تكوين عدة مزودين، فسيُستخدم المزود المحدد أولًا وتكون المزودات
الأخرى خيارات احتياطية. يستخدم التلخيص التلقائي summaryModel (أو
agents.defaults.model.primary)، لذلك يجب أيضًا مصادقة ذلك المزود إذا
أبقيت الملخصات مفعّلة.
التكوين
يوجد تكوين TTS ضمن messages.tts في ~/.openclaw/openclaw.json. اختر
إعدادًا مسبقًا وعدّل كتلة المزود:
Azure Speech
{messages: {tts: { auto: "always", provider: "azure-speech", providers: { "azure-speech": { apiKey: "${AZURE_SPEECH_KEY}", region: "eastus", speakerVoice: "en-US-JennyNeural", lang: "en-US", outputFormat: "audio-24khz-48kbitrate-mono-mp3", voiceNoteOutputFormat: "ogg-24khz-16bit-mono-opus", }, },},},}ElevenLabs
{messages: {tts: { auto: "always", provider: "elevenlabs", providers: { elevenlabs: { apiKey: "${ELEVENLABS_API_KEY}", model: "eleven_multilingual_v2", speakerVoiceId: "EXAVITQu4vr4xnSDxMaL", }, },},},}Google Gemini
{messages: {tts: { auto: "always", provider: "google", providers: { google: { apiKey: "${GEMINI_API_KEY}", model: "gemini-3.1-flash-tts-preview", speakerVoice: "Kore", // Optional natural-language style prompts: // audioProfile: "Speak in a calm, podcast-host tone.", // speakerName: "Alex", }, },},},}Gradium
{messages: {tts: { auto: "always", provider: "gradium", providers: { gradium: { apiKey: "${GRADIUM_API_KEY}", speakerVoiceId: "YTpq7expH9539ERJ", }, },},},}Inworld
{messages: {tts: { auto: "always", provider: "inworld", providers: { inworld: { apiKey: "${INWORLD_API_KEY}", modelId: "inworld-tts-1.5-max", speakerVoiceId: "Sarah", temperature: 0.7, }, },},},}Local CLI
{messages: {tts: { auto: "always", provider: "tts-local-cli", providers: { "tts-local-cli": { command: "say", args: ["-o", "{{OutputPath}}", "{{Text}}"], outputFormat: "wav", timeoutMs: 120000, }, },},},}Microsoft (no key)
{messages: {tts: { auto: "always", provider: "microsoft", providers: { microsoft: { enabled: true, speakerVoice: "en-US-MichelleNeural", lang: "en-US", outputFormat: "audio-24khz-48kbitrate-mono-mp3", rate: "+0%", pitch: "+0%", }, },},},}MiniMax
{messages: {tts: { auto: "always", provider: "minimax", providers: { minimax: { apiKey: "${MINIMAX_API_KEY}", model: "speech-2.8-hd", speakerVoiceId: "English_expressive_narrator", speed: 1.0, vol: 1.0, pitch: 0, }, },},},}OpenAI + ElevenLabs
{messages: {tts: { auto: "always", provider: "openai", summaryModel: "openai/gpt-4.1-mini", modelOverrides: { enabled: true }, providers: { openai: { apiKey: "${OPENAI_API_KEY}", model: "gpt-4o-mini-tts", speakerVoice: "alloy", }, elevenlabs: { apiKey: "${ELEVENLABS_API_KEY}", model: "eleven_multilingual_v2", speakerVoiceId: "EXAVITQu4vr4xnSDxMaL", voiceSettings: { stability: 0.5, similarityBoost: 0.75, style: 0.0, useSpeakerBoost: true, speed: 1.0 }, applyTextNormalization: "auto", languageCode: "en", }, },},},}OpenRouter
{messages: {tts: { auto: "always", provider: "openrouter", providers: { openrouter: { apiKey: "${OPENROUTER_API_KEY}", model: "hexgrad/kokoro-82m", speakerVoice: "af_alloy", responseFormat: "mp3", }, },},},}Volcengine
{messages: {tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "${VOLCENGINE_TTS_API_KEY}", resourceId: "seed-tts-1.0", speakerVoice: "en_female_anna_mars_bigtts", }, },},},}xAI
{messages: {tts: { auto: "always", provider: "xai", providers: { xai: { apiKey: "${XAI_API_KEY}", speakerVoiceId: "eve", language: "en", responseFormat: "mp3", }, },},},}Xiaomi MiMo
{messages: {tts: { auto: "always", provider: "xiaomi", providers: { xiaomi: { apiKey: "${XIAOMI_API_KEY}", model: "mimo-v2.5-tts", speakerVoice: "mimo_default", format: "mp3", }, },},},}بالنسبة إلى Xiaomi mimo-v2.5-tts-voicedesign، احذف speakerVoice واضبط
style على مطالبة تصميم الصوت. يرسل OpenClaw تلك المطالبة كرسالة TTS
user ولا يرسل audio.voice لنموذج voicedesign.
تجاوزات الصوت لكل وكيل
استخدم agents.list[].tts عندما يجب أن يتحدث وكيل واحد بموفر أو
صوت أو نموذج أو شخصية أو وضع TTS تلقائي مختلف. تدمج كتلة الوكيل بعمق فوق
messages.tts، لذلك يمكن أن تبقى بيانات اعتماد الموفر في إعدادات الموفر العامة:
{ messages: { tts: { auto: "always", provider: "elevenlabs", providers: { elevenlabs: { apiKey: "${ELEVENLABS_API_KEY}", model: "eleven_multilingual_v2" }, }, }, }, agents: { list: [ { id: "reader", tts: { providers: { elevenlabs: { speakerVoiceId: "EXAVITQu4vr4xnSDxMaL" }, }, }, }, ], },}لتثبيت شخصية لكل وكيل، اضبط agents.list[].tts.persona بجانب إعدادات
الموفر — فهي تتجاوز messages.tts.persona العامة لذلك الوكيل فقط.
ترتيب الأولوية للردود التلقائية، و/tts audio، و/tts status، وأداة الوكيل
tts:
messages.ttsagents.list[].ttsالنشطة- تجاوز القناة، عندما تدعم القناة
channels.<channel>.tts - تجاوز الحساب، عندما تمرر القناة
channels.<channel>.accounts.<id>.tts - تفضيلات
/ttsالمحلية لهذا المضيف - توجيهات
[[tts:...]]المضمنة عندما تكون تجاوزات النموذج مفعلة
تستخدم تجاوزات القناة والحساب البنية نفسها مثل messages.tts وتدمج بعمق
فوق الطبقات السابقة، لذلك يمكن أن تبقى بيانات اعتماد الموفر المشتركة في
messages.tts بينما تغير قناة أو حساب بوت صوت المتحدث أو النموذج أو الشخصية
أو الوضع التلقائي فقط:
{ messages: { tts: { provider: "openai", providers: { openai: { apiKey: "${OPENAI_API_KEY}", model: "gpt-4o-mini-tts" }, }, }, }, channels: { feishu: { accounts: { english: { tts: { providers: { openai: { speakerVoice: "shimmer" }, }, }, }, }, }, },}الشخصيات
الشخصية هي هوية منطوقة ثابتة يمكن تطبيقها بشكل حتمي عبر الموفرين. يمكنها تفضيل موفر واحد، وتعريف نية مطالبة محايدة للموفر، وحمل ربطات خاصة بالموفر للأصوات والنماذج وقوالب المطالبات والبذور وإعدادات الصوت.
شخصية مبسطة
{ messages: { tts: { auto: "always", persona: "narrator", personas: { narrator: { label: "Narrator", provider: "elevenlabs", providers: { elevenlabs: { speakerVoiceId: "EXAVITQu4vr4xnSDxMaL", modelId: "eleven_multilingual_v2", }, }, }, }, }, },}شخصية كاملة (مطالبة محايدة للموفر)
{ messages: { tts: { auto: "always", persona: "alfred", personas: { alfred: { label: "Alfred", description: "Dry, warm British butler narrator.", provider: "google", fallbackPolicy: "preserve-persona", prompt: { profile: "A brilliant British butler. Dry, witty, warm, charming, emotionally expressive, never generic.", scene: "A quiet late-night study. Close-mic narration for a trusted operator.", sampleContext: "The speaker is answering a private technical request with concise confidence and dry warmth.", style: "Refined, understated, lightly amused.", accent: "British English.", pacing: "Measured, with short dramatic pauses.", constraints: ["Do not read configuration values aloud.", "Do not explain the persona."], }, providers: { google: { model: "gemini-3.1-flash-tts-preview", speakerVoice: "Algieba", promptTemplate: "audio-profile-v1", }, openai: { model: "gpt-4o-mini-tts", speakerVoice: "cedar" }, elevenlabs: { speakerVoiceId: "voice_id", modelId: "eleven_multilingual_v2", seed: 42, voiceSettings: { stability: 0.65, similarityBoost: 0.8, style: 0.25, useSpeakerBoost: true, speed: 0.95, }, }, }, }, }, }, },}حلّ الشخصية
تُحدد الشخصية النشطة بشكل حتمي:
- تفضيل
/tts persona <id>المحلي، إذا كان مضبوطًا. messages.tts.persona، إذا كان مضبوطًا.- بلا شخصية.
يعمل اختيار الموفر بترتيب الصريح أولًا:
- التجاوزات المباشرة (CLI، وGateway، وTalk، وتوجيهات TTS المسموح بها).
- تفضيل
/tts provider <id>المحلي. providerالخاص بالشخصية النشطة.messages.tts.provider.- الاختيار التلقائي من السجل.
لكل محاولة موفر، يدمج OpenClaw الإعدادات بهذا الترتيب:
messages.tts.providers.<id>messages.tts.personas.<persona>.providers.<id>- تجاوزات الطلب الموثوق بها
- تجاوزات توجيهات TTS التي يصدرها النموذج والمسموح بها
كيف تستخدم الموفرات مطالبات الشخصية
حقول مطالبة الشخصية (profile، وscene، وsampleContext، وstyle، وaccent،
وpacing، وconstraints) محايدة للموفر. يقرر كل موفر كيفية
استخدامها:
Google Gemini
يلف حقول مطالبة الشخصية في بنية مطالبة Gemini TTS فقط عندما
تضبط إعدادات موفر Google الفعالة promptTemplate: "audio-profile-v1"
أو personaPrompt. ما زالت حقول audioProfile وspeakerName الأقدم
تسبق النص كنص مطالبة خاص بـ Google. تُحفظ وسوم الصوت المضمنة مثل
[whispers] أو [laughs] داخل كتلة [[tts:text]]
داخل نص Gemini؛ لا ينشئ OpenClaw هذه الوسوم.
OpenAI
يطابق حقول مطالبة الشخصية إلى حقل الطلب instructions فقط عندما
لا تكون هناك instructions صريحة مهيأة لـ OpenAI. تفوز instructions
الصريحة دائمًا.
الموفرون الآخرون
يستخدمون فقط ربطات الشخصية الخاصة بالموفر تحت
personas.<id>.providers.<provider>. تُتجاهل حقول مطالبة الشخصية
ما لم ينفذ الموفر تعيين مطالبات شخصية خاصًا به.
سياسة الرجوع
يتحكم fallbackPolicy في السلوك عندما لا تملك الشخصية أي ربط للموفر
الذي تجري محاولة استخدامه:
| السياسة | السلوك |
|---|---|
preserve-persona |
الافتراضي. تبقى حقول المطالبة المحايدة للموفر متاحة؛ قد يستخدمها الموفر أو يتجاهلها. |
provider-defaults |
تُحذف الشخصية من تحضير المطالبة لتلك المحاولة؛ يستخدم الموفر افتراضاته المحايدة بينما يستمر الرجوع إلى موفرين آخرين. |
fail |
تخطَّ محاولة ذلك الموفر مع reasonCode: "not_configured" وpersonaBinding: "missing". تبقى موفرات الرجوع قيد المحاولة. |
يفشل طلب TTS بأكمله فقط عندما تُتخطى كل محاولات الموفرين أو تفشل.
اختيار موفر جلسة Talk محصور بنطاق الجلسة. يجب على عميل Talk اختيار
معرفات الموفرين، ومعرفات النماذج، ومعرفات الأصوات، واللغات المحلية من
talk.catalog وتمريرها عبر جلسة Talk أو طلب التسليم. يجب ألا يؤدي فتح
جلسة صوتية إلى تعديل messages.tts أو افتراضات موفر Talk العامة.
التوجيهات المدفوعة بالنموذج
افتراضيًا، يمكن للمساعد إصدار توجيهات [[tts:...]] لتجاوز
الصوت أو النموذج أو السرعة لرد واحد، بالإضافة إلى كتلة اختيارية
[[tts:text]]...[[/tts:text]] للإشارات التعبيرية التي يجب أن تظهر في
الصوت فقط:
Here you go. [[tts:speakerVoiceId=pMsXgVXv3BLzUgSXRplE model=eleven_v3 speed=1.1]][[tts:text]](laughs) Read the song once more.[[/tts:text]]عندما يكون messages.tts.auto هو "tagged"، تكون التوجيهات مطلوبة
لتشغيل الصوت. يزيل تسليم الكتل المتدفقة التوجيهات من النص المرئي قبل أن
تراها القناة، حتى عندما تكون مقسمة عبر كتل متجاورة.
يُتجاهل provider=... ما لم يكن modelOverrides.allowProvider: true.
عندما يعلن رد provider=...، تُحلل المفاتيح الأخرى في ذلك التوجيه
بواسطة ذلك الموفر فقط؛ تُزال المفاتيح غير المدعومة ويُبلغ عنها كتحذيرات
توجيه TTS.
مفاتيح التوجيه المتاحة:
provider(معرف موفر مسجل؛ يتطلبallowProvider: true)speakerVoice/speakerVoiceId(أسماء مستعارة قديمة:voice، وvoiceName، وvoice_name، وgoogle_voice، وvoiceId)model/google_modelstability، وsimilarityBoost، وstyle، وspeed، وuseSpeakerBoostvol/volume(مستوى صوت MiniMax، 0–10)pitch(درجة صوت MiniMax عددية صحيحة، −12 إلى 12؛ تُقتطع القيم الكسرية)emotion(وسم عاطفة Volcengine)applyTextNormalization(auto|on|off)languageCode(ISO 639-1)seed
تعطيل تجاوزات النموذج بالكامل:
{ messages: { tts: { modelOverrides: { enabled: false } } } }السماح بتبديل الموفر مع إبقاء عناصر التحكم الأخرى قابلة للتهيئة:
{ messages: { tts: { modelOverrides: { enabled: true, allowProvider: true, allowSeed: false } } } }أوامر الشرطة المائلة
أمر واحد /tts. على Discord، يسجل OpenClaw أيضًا /voice لأن
/tts أمر مدمج في Discord — ما زال نص /tts ... يعمل.
/tts off | on | status/tts chat on | off | default/tts latest/tts provider <id>/tts persona <id> | off/tts limit <chars>/tts summary off/tts audio <text>ملاحظات السلوك:
- يكتب
/tts onتفضيل TTS المحلي إلىalways؛ ويكتبه/tts offإلىoff. - يكتب
/tts chat on|off|defaultتجاوزًا لوضع TTS التلقائي محصورًا بنطاق الجلسة للمحادثة الحالية. - يكتب
/tts persona <id>تفضيل الشخصية المحلي؛ ويمسحه/tts persona off. - يقرأ
/tts latestأحدث رد للمساعد من سجل الجلسة الحالية ويرسله كصوت مرة واحدة. يخزن فقط تجزئة ذلك الرد في إدخال الجلسة لمنع إرسال صوت مكرر. - ينشئ
/tts audioردًا صوتيًا لمرة واحدة (لا يبدل TTS إلى وضع التشغيل). - يُخزن
limitوsummaryفي التفضيلات المحلية، وليس في الإعدادات الرئيسية. - يتضمن
/tts statusتشخيصات الرجوع لأحدث محاولة —Fallback: <primary> -> <used>، وAttempts: ...، وتفاصيل كل محاولة (provider:outcome(reasonCode) latency). - يعرض
/statusوضع TTS النشط بالإضافة إلى الموفر والنموذج والصوت المهيأة وبيانات التعريف المنقحة لنقطة النهاية المخصصة عندما يكون TTS مفعلًا.
تفضيلات لكل مستخدم
تكتب أوامر الشرطة المائلة التجاوزات المحلية إلى prefsPath. القيمة الافتراضية هي
~/.openclaw/settings/tts.json؛ ويمكن تجاوزها بمتغير البيئة OPENCLAW_TTS_PREFS
أو messages.tts.prefsPath.
| الحقل المخزن | التأثير |
|---|---|
auto |
تجاوز TTS التلقائي المحلي (always، وoff، …) |
provider |
تجاوز الموفر الأساسي المحلي |
persona |
تجاوز الشخصية المحلي |
maxLength |
عتبة التلخيص (افتراضيًا 1500 حرفًا) |
summarize |
مفتاح التلخيص (افتراضيًا true) |
تتجاوز هذه الإعدادات الفعالة من messages.tts بالإضافة إلى كتلة
agents.list[].tts النشطة لذلك المضيف.
تنسيقات الإخراج (ثابتة)
يُدار تسليم صوت TTS حسب قدرات القناة. تعلن Plugins القنوات
ما إذا كان TTS بنمط الصوت يجب أن يطلب من الموفرين هدف voice-note أصليًا
أو يحافظ على إنشاء audio-file العادي ويضع علامة فقط على الإخراج المتوافق
مع التسليم الصوتي.
- القنوات القادرة على الملاحظات الصوتية: تفضّل ردود الملاحظات الصوتية Opus (
opus_48000_64من ElevenLabs، وopusمن OpenAI).- 48kHz / 64kbps هو توازن جيد لرسائل الصوت.
- Feishu / WhatsApp: عند إنتاج رد ملاحظة صوتية بصيغة MP3/WebM/WAV/M4A
أو ملف صوتي آخر محتمل، يحوّله Plugin القناة إلى 48kHz
Ogg/Opus باستخدام
ffmpegقبل إرسال رسالة الصوت الأصلية. يرسل WhatsApp النتيجة عبر حمولة Baileysaudioمعptt: trueوaudio/ogg; codecs=opus. إذا فشل التحويل، يتلقى Feishu الملف الأصلي كمرفق؛ ويفشل إرسال WhatsApp بدلًا من نشر حمولة PTT غير متوافقة. - القنوات الأخرى: MP3 (
mp3_44100_128من ElevenLabs، وmp3من OpenAI).- 44.1kHz / 128kbps هو التوازن الافتراضي لوضوح الكلام.
- MiniMax: MP3 (نموذج
speech-2.8-hd، ومعدل عينة 32kHz) لمرفقات الصوت العادية. بالنسبة إلى أهداف الملاحظات الصوتية التي تعلنها القناة، يحوّل OpenClaw ملف MiniMax MP3 إلى 48kHz Opus باستخدامffmpegقبل التسليم عندما تعلن القناة دعم التحويل. - Xiaomi MiMo: MP3 افتراضيًا، أو WAV عند تهيئته. بالنسبة إلى أهداف الملاحظات الصوتية التي تعلنها القناة، يحوّل OpenClaw مخرجات Xiaomi إلى 48kHz Opus باستخدام
ffmpegقبل التسليم عندما تعلن القناة دعم التحويل. - CLI المحلي: يستخدم
outputFormatالمهيأ. تُحوَّل أهداف الملاحظات الصوتية إلى Ogg/Opus، وتُحوَّل مخرجات الاتصالات الهاتفية إلى PCM خام أحادي 16 kHz باستخدامffmpeg. - Google Gemini: تعيد Gemini API TTS بيانات PCM خام بمعدل 24kHz. يغلّفها OpenClaw بصيغة WAV لمرفقات الصوت، ويحوّلها إلى 48kHz Opus لأهداف الملاحظات الصوتية، ويعيد PCM مباشرةً لـ Talk/الاتصالات الهاتفية.
- Gradium: WAV لمرفقات الصوت، وOpus لأهداف الملاحظات الصوتية، و
ulaw_8000عند 8 kHz للاتصالات الهاتفية. - Inworld: MP3 لمرفقات الصوت العادية، و
OGG_OPUSأصلي لأهداف الملاحظات الصوتية، وPCMخام عند 22050 Hz لـ Talk/الاتصالات الهاتفية. - xAI: MP3 افتراضيًا؛ يمكن أن تكون
responseFormatإحدى القيمmp3أوwavأوpcmأوmulawأوalaw. يستخدم OpenClaw نقطة نهاية TTS الدُفعية عبر REST من xAI ويعيد مرفقًا صوتيًا كاملًا؛ ولا يستخدم مسار هذا المزوّد WebSocket الخاص ببث TTS من xAI. لا يدعم هذا المسار تنسيق Opus الأصلي للملاحظات الصوتية. - Microsoft: يستخدم
microsoft.outputFormat(الافتراضيaudio-24khz-48kbitrate-mono-mp3).- يقبل النقل المضمّن
outputFormat، لكن ليست كل التنسيقات متاحة من الخدمة. - تتبع قيم تنسيق الإخراج تنسيقات إخراج Microsoft Speech (بما في ذلك Ogg/WebM Opus).
- يقبل Telegram
sendVoiceصيغ OGG/MP3/M4A؛ استخدم OpenAI/ElevenLabs إذا كنت تحتاج إلى رسائل صوتية Opus مضمونة. - إذا فشل تنسيق إخراج Microsoft المهيأ، يعيد OpenClaw المحاولة باستخدام MP3.
- يقبل النقل المضمّن
تنسيقات إخراج OpenAI/ElevenLabs ثابتة لكل قناة (انظر أعلاه).
سلوك Auto-TTS
عند تفعيل messages.tts.auto، يقوم OpenClaw بما يلي:
- يتجاوز TTS إذا كان الرد يحتوي بالفعل على وسائط منظمة.
- يتجاوز الردود القصيرة جدًا (أقل من 10 أحرف).
- يلخّص الردود الطويلة عند تفعيل الملخصات، باستخدام
summaryModel(أوagents.defaults.model.primary). - يرفق الصوت المُنشأ بالرد.
- في
mode: "final"، يظل يرسل TTS صوتيًا فقط للردود النهائية المتدفقة بعد اكتمال تدفق النص؛ تمر الوسائط المُنشأة عبر تطبيع وسائط القناة نفسه المستخدم مع مرفقات الرد العادية.
إذا تجاوز الرد maxLength وكان التلخيص متوقفًا (أو لا يوجد مفتاح API لنموذج
التلخيص)، يتم تجاوز الصوت وإرسال الرد النصي العادي.
Reply -> TTS enabled? no -> send text yes -> has media / short? yes -> send text no -> length > limit? no -> TTS -> attach audio yes -> summary enabled? no -> send text yes -> summarize -> TTS -> attach audioتنسيقات الإخراج حسب القناة
| الهدف | التنسيق |
|---|---|
| Feishu / Matrix / Telegram / WhatsApp | تفضّل ردود الملاحظات الصوتية Opus (opus_48000_64 من ElevenLabs، وopus من OpenAI). يوازن 48 kHz / 64 kbps بين الوضوح والحجم. |
| القنوات الأخرى | MP3 (mp3_44100_128 من ElevenLabs، وmp3 من OpenAI). الإعداد الافتراضي للكلام هو 44.1 kHz / 128 kbps. |
| المحادثة / الاتصالات الهاتفية | PCM الأصلي من المزوّد (Inworld 22050 Hz، وGoogle 24 kHz)، أو ulaw_8000 من Gradium للاتصالات الهاتفية. |
ملاحظات حسب المزوّد:
- تحويل ترميز Feishu / WhatsApp: عندما يصل رد ملاحظة صوتية بصيغة MP3/WebM/WAV/M4A، يحوّل Plugin القناة الترميز إلى Ogg/Opus بتردد 48 kHz باستخدام
ffmpeg. يرسل WhatsApp عبر Baileys معptt: trueوaudio/ogg; codecs=opus. إذا فشل التحويل: يعود Feishu إلى إرفاق الملف الأصلي؛ ويفشل إرسال WhatsApp بدلاً من نشر حمولة PTT غير متوافقة. - MiniMax / Xiaomi MiMo: MP3 افتراضيًا (32 kHz لـ MiniMax
speech-2.8-hd)؛ ويُحوَّل ترميزه إلى Opus بتردد 48 kHz لأهداف الملاحظات الصوتية عبرffmpeg. - CLI المحلي: يستخدم
outputFormatالمضبوط. تُحوَّل أهداف الملاحظات الصوتية إلى Ogg/Opus ومخرجات الاتصالات الهاتفية إلى PCM أحادي خام بتردد 16 kHz. - Google Gemini: يعيد PCM خامًا بتردد 24 kHz. يغلّفه OpenClaw كـ WAV للمرفقات، ويحوّل ترميزه إلى Opus بتردد 48 kHz لأهداف الملاحظات الصوتية، ويعيد PCM مباشرةً للمحادثة/الاتصالات الهاتفية.
- Inworld: مرفقات MP3، وملاحظة صوتية أصلية
OGG_OPUS، وPCMخام بتردد 22050 Hz للمحادثة/الاتصالات الهاتفية. - xAI: MP3 افتراضيًا؛ يمكن أن تكون
responseFormatهيmp3|wav|pcm|mulaw|alaw. يستخدم نقطة نهاية REST الدُفعية الخاصة بـ xAI — ولا يُستخدم WebSocket TTS للبث مطلقًا. تنسيق الملاحظات الصوتية الأصلي Opus غير مدعوم. - Microsoft: يستخدم
microsoft.outputFormat(الافتراضيaudio-24khz-48kbitrate-mono-mp3). يقبلsendVoiceفي Telegram صيغ OGG/MP3/M4A؛ استخدم OpenAI/ElevenLabs إذا كنت تحتاج إلى رسائل صوتية Opus مضمونة. إذا فشل تنسيق Microsoft المضبوط، يعيد OpenClaw المحاولة باستخدام MP3.
تنسيقات مخرجات OpenAI وElevenLabs ثابتة لكل قناة كما هو مذكور أعلاه.
مرجع الحقول
رسائل المستوى الأعلى messages.tts.*
auto"off" | "always" | "inbound" | "tagged"وضع TTS التلقائي. يرسل inbound الصوت فقط بعد رسالة صوتية واردة؛ ويرسل tagged الصوت فقط عندما يتضمن الرد توجيهات [[tts:...]] أو كتلة [[tts:text]].
enabledbooleanمفتاح تبديل قديم. يرحّل openclaw doctor --fix هذا إلى auto.
mode"final" | "all"default: finalيتضمن "all" ردود الأدوات/الكتل بالإضافة إلى الردود النهائية.
providerstringمعرّف مزوّد الكلام. عند عدم تعيينه، يستخدم OpenClaw أول مزوّد مضبوط في ترتيب الاختيار التلقائي للسجل. يُعاد كتابة provider: "edge" القديم إلى "microsoft" بواسطة openclaw doctor --fix.
personastringمعرّف الشخصية النشطة من personas. يُطبّع إلى أحرف صغيرة.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InBlcnNvbmFzLjxpZA
" type="object">
هوية منطوقة مستقرة. الحقول: label وdescription وprovider وfallbackPolicy وprompt وproviders.<provider>. راجع الشخصيات.
summaryModelstringنموذج منخفض التكلفة للملخص التلقائي؛ يكون افتراضيًا agents.defaults.model.primary. يقبل provider/model أو اسمًا مستعارًا لنموذج مضبوط.
modelOverridesobjectيسمح للنموذج بإصدار توجيهات TTS. تكون قيمة enabled الافتراضية true؛ وتكون قيمة allowProvider الافتراضية false.
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InByb3ZpZGVycy48aWQ
" type="object">
إعدادات مملوكة للمزوّد ومفهرسة حسب معرّف مزوّد الكلام. يعيد openclaw doctor --fix كتابة الكتل المباشرة القديمة (messages.tts.openai و.elevenlabs و.microsoft و.edge)؛ لا تثبّت إلا messages.tts.providers.<id>.
maxTextLengthnumberحد صارم لعدد أحرف إدخال TTS. يفشل /tts audio إذا تم تجاوزه.
timeoutMsnumberمهلة الطلب بالميلي ثانية.
prefsPathstringيتجاوز مسار JSON المحلي للتفضيلات (المزوّد/الحد/الملخص). الافتراضي ~/.openclaw/settings/tts.json.
Azure Speech
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
Env: AZURE_SPEECH_KEY أو AZURE_SPEECH_API_KEY أو SPEECH_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlZ2lvbiIgdHlwZT0ic3RyaW5nIg
منطقة Azure Speech (مثل eastus). Env: AZURE_SPEECH_REGION أو SPEECH_REGION.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImVuZHBvaW50IiB0eXBlPSJzdHJpbmci
تجاوز اختياري لنقطة نهاية Azure Speech (الاسم المستعار baseUrl).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
ShortName لصوت Azure. الافتراضي en-US-JennyNeural. الاسم المستعار القديم: voice.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImxhbmciIHR5cGU9InN0cmluZyI
رمز لغة SSML. الافتراضي en-US.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im91dHB1dEZvcm1hdCIgdHlwZT0ic3RyaW5nIg
قيمة Azure X-Microsoft-OutputFormat للصوت القياسي. الافتراضي audio-24khz-48kbitrate-mono-mp3.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvaWNlTm90ZU91dHB1dEZvcm1hdCIgdHlwZT0ic3RyaW5nIg
قيمة Azure X-Microsoft-OutputFormat لمخرجات الملاحظات الصوتية. الافتراضي ogg-24khz-16bit-mono-opus.
OPENCLAW_DOCS_MARKER:paramClose:
ElevenLabs
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
يعود احتياطيًا إلى ELEVENLABS_API_KEY أو XI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
معرّف النموذج (مثل eleven_multilingual_v2 وeleven_v3).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZUlkIiB0eXBlPSJzdHJpbmci
معرّف صوت ElevenLabs. الاسم المستعار القديم: voiceId.
OPENCLAW_DOCS_MARKER:paramClose:
voiceSettingsobjectstability وsimilarityBoost وstyle (كل منها 0..1) وuseSpeakerBoost (true|false) وspeed (0.5..2.0، 1.0 = عادي).
applyTextNormalization"auto" | "on" | "off"OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Imxhbmd1YWdlQ29kZSIgdHlwZT0ic3RyaW5nIg
رمز ISO 639-1 مكوّن من حرفين (مثل en وde).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNlZWQiIHR5cGU9Im51bWJlciI
عدد صحيح 0..4294967295 لتحقيق حتمية بأفضل جهد.
OPENCLAW_DOCS_MARKER:paramClose:
baseUrlstringGoogle Gemini
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
يعود احتياطيًا إلى GEMINI_API_KEY / GOOGLE_API_KEY. إذا حُذف، يمكن لـ TTS إعادة استخدام models.providers.google.apiKey قبل الرجوع الاحتياطي إلى Env.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
نموذج Gemini TTS. الافتراضي gemini-3.1-flash-tts-preview.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
اسم صوت Gemini مسبق الإنشاء. الافتراضي Kore. الأسماء المستعارة القديمة: voiceName وvoice.
OPENCLAW_DOCS_MARKER:paramClose:
audioProfilestringspeakerNamestringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InByb21wdFRlbXBsYXRlIiB0eXBlPSciYXVkaW8tcHJvZmlsZS12MSIn
عيّنه إلى audio-profile-v1 لتغليف حقول موجه الشخصية النشطة في بنية موجه Gemini TTS حتمية.
OPENCLAW_DOCS_MARKER:paramClose:
personaPromptstringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
لا يُقبل إلا https://generativelanguage.googleapis.com.
OPENCLAW_DOCS_MARKER:paramClose:
Gradium
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
البيئة: GRADIUM_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
القيمة الافتراضية https://api.gradium.ai.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZUlkIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية Emma (YTpq7expH9539ERJ). الاسم البديل القديم: voiceId.
OPENCLAW_DOCS_MARKER:paramClose:
Inworld
Inworld الأساسي
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
البيئة: INWORLD_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
القيمة الافتراضية https://api.inworld.ai.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsSWQiIHR5cGU9InN0cmluZyI
القيمة الافتراضية inworld-tts-1.5-max. أيضًا: inworld-tts-1.5-mini، inworld-tts-1-max، inworld-tts-1.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZUlkIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية Sarah. الاسم البديل القديم: voiceId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRlbXBlcmF0dXJlIiB0eXBlPSJudW1iZXIi
درجة حرارة أخذ العينات 0..2.
OPENCLAW_DOCS_MARKER:paramClose:
Local CLI (tts-local-cli)
commandstringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFyZ3MiIHR5cGU9InN0cmluZ1tdIg
وسائط الأمر. تدعم العناصر النائبة {{Text}} و{{OutputPath}} و{{OutputDir}} و{{OutputBase}}.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im91dHB1dEZvcm1hdCIgdHlwZT0nIm1wMyIgfCAib3B1cyIgfCAid2F2Iic
تنسيق مخرجات CLI المتوقع. القيمة الافتراضية mp3 لمرفقات الصوت.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg
مهلة الأمر بالمللي ثانية. القيمة الافتراضية 120000.
OPENCLAW_DOCS_MARKER:paramClose:
cwdstringenvRecord<string, string��-���$�u$0����4Microsoft (no API key)
enabledbooleandefault: trueOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
اسم الصوت العصبي في Microsoft (مثل en-US-MichelleNeural). الاسم البديل القديم: voice.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImxhbmciIHR5cGU9InN0cmluZyI
رمز اللغة (مثل en-US).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im91dHB1dEZvcm1hdCIgdHlwZT0ic3RyaW5nIg
تنسيق مخرجات Microsoft. القيمة الافتراضية audio-24khz-48kbitrate-mono-mp3. لا يدعم النقل المضمن المستند إلى Edge جميع التنسيقات.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJhdGUgLyBwaXRjaCAvIHZvbHVtZSIgdHlwZT0ic3RyaW5nIg
سلاسل نسب مئوية (مثل +10% و-5%).
OPENCLAW_DOCS_MARKER:paramClose:
saveSubtitlesbooleanproxystringtimeoutMsnumberOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImVkZ2UuKiIgdHlwZT0ib2JqZWN0IiBkZXByZWNhdGVk
اسم بديل قديم. شغّل openclaw doctor --fix لإعادة كتابة الإعدادات المحفوظة إلى providers.microsoft.
OPENCLAW_DOCS_MARKER:paramClose:
MiniMax
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
يرجع إلى MINIMAX_API_KEY. مصادقة Token Plan عبر MINIMAX_OAUTH_TOKEN أو MINIMAX_CODE_PLAN_KEY أو MINIMAX_CODING_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
القيمة الافتراضية https://api.minimax.io. البيئة: MINIMAX_API_HOST.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية speech-2.8-hd. البيئة: MINIMAX_TTS_MODEL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZUlkIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية English_expressive_narrator. البيئة: MINIMAX_TTS_VOICE_ID. الاسم البديل القديم: voiceId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWVkIiB0eXBlPSJudW1iZXIi
0.5..2.0. القيمة الافتراضية 1.0.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InZvbCIgdHlwZT0ibnVtYmVyIg
(0, 10]. القيمة الافتراضية 1.0.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InBpdGNoIiB0eXBlPSJudW1iZXIi
عدد صحيح -12..12. القيمة الافتراضية 0. تُقتطع القيم الكسرية قبل الطلب.
OPENCLAW_DOCS_MARKER:paramClose:
OpenAI
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
يرجع إلى OPENAI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
معرّف نموذج تحويل النص إلى كلام في OpenAI (مثل gpt-4o-mini-tts).
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
اسم الصوت (مثل alloy وcedar). الاسم البديل القديم: voice.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Imluc3RydWN0aW9ucyIgdHlwZT0ic3RyaW5nIg
حقل instructions صريح من OpenAI. عند تعيينه، لا تُربط حقول موجه الشخصية تلقائيًا.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImV4dHJhQm9keSAvIGV4dHJhX2JvZHkiIHR5cGU9IlJlY29yZDxzdHJpbmcsIHVua25vd24
">حقول JSON إضافية تُدمج في أجسام طلبات /audio/speech بعد حقول تحويل النص إلى كلام المولدة من OpenAI. استخدم هذا لنقاط النهاية المتوافقة مع OpenAI مثل Kokoro التي تتطلب مفاتيح خاصة بالمزوّد مثل lang؛ يتم تجاهل مفاتيح النماذج الأولية غير الآمنة.
OPENCLAW_DOCS_MARKER:paramClose:
baseUrlstringتجاوز نقطة نهاية تحويل النص إلى كلام في OpenAI. ترتيب الحل: الإعدادات → OPENAI_TTS_BASE_URL → https://api.openai.com/v1. تُعامل القيم غير الافتراضية كنقاط نهاية لتحويل النص إلى كلام متوافقة مع OpenAI، لذلك تُقبل أسماء النماذج والأصوات المخصصة.
OpenRouter
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
البيئة: OPENROUTER_API_KEY. يمكن إعادة استخدام models.providers.openrouter.apiKey.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
القيمة الافتراضية https://openrouter.ai/api/v1. يتم تطبيع https://openrouter.ai/v1 القديم.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية hexgrad/kokoro-82m. الاسم البديل: modelId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
القيمة الافتراضية af_alloy. الأسماء البديلة القديمة: voice وvoiceId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlc3BvbnNlRm9ybWF0IiB0eXBlPScibXAzIiB8ICJwY20iJw
القيمة الافتراضية mp3.
OPENCLAW_DOCS_MARKER:paramClose:
speednumberVolcengine (BytePlus Seed Speech)
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
البيئة: VOLCENGINE_TTS_API_KEY أو BYTEPLUS_SEED_SPEECH_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlc291cmNlSWQiIHR5cGU9InN0cmluZyI
القيمة الافتراضية seed-tts-1.0. البيئة: VOLCENGINE_TTS_RESOURCE_ID. استخدم seed-tts-2.0 عندما يكون لمشروعك استحقاق TTS 2.0.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwcEtleSIgdHlwZT0ic3RyaW5nIg
ترويسة مفتاح التطبيق. القيمة الافتراضية aGjiRDfUWi. البيئة: VOLCENGINE_TTS_APP_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
تجاوز نقطة نهاية HTTP لتحويل النص إلى كلام في Seed Speech. البيئة: VOLCENGINE_TTS_BASE_URL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
نوع الصوت. القيمة الافتراضية en_female_anna_mars_bigtts. البيئة: VOLCENGINE_TTS_VOICE. الاسم البديل القديم: voice.
OPENCLAW_DOCS_MARKER:paramClose:
speedRationumberemotionstringOPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwcElkIC8gdG9rZW4gLyBjbHVzdGVyIiB0eXBlPSJzdHJpbmciIGRlcHJlY2F0ZWQ
حقول Volcengine Speech Console القديمة. البيئة: VOLCENGINE_TTS_APPID وVOLCENGINE_TTS_TOKEN وVOLCENGINE_TTS_CLUSTER (القيمة الافتراضية volcano_tts).
OPENCLAW_DOCS_MARKER:paramClose:
xAI
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
البيئة: XAI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
القيمة الافتراضية https://api.x.ai/v1. البيئة: XAI_BASE_URL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZUlkIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية eve. الأصوات الحية: ara وeve وleo وrex وsal وuna. الاسم البديل القديم: voiceId.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Imxhbmd1YWdlIiB0eXBlPSJzdHJpbmci
رمز لغة BCP-47 أو auto. القيمة الافتراضية en.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InJlc3BvbnNlRm9ybWF0IiB0eXBlPScibXAzIiB8ICJ3YXYiIHwgInBjbSIgfCAibXVsYXciIHwgImFsYXciJw
القيمة الافتراضية mp3.
OPENCLAW_DOCS_MARKER:paramClose:
speednumberXiaomi MiMo
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImFwaUtleSIgdHlwZT0ic3RyaW5nIg
البيئة: XIAOMI_API_KEY.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImJhc2VVcmwiIHR5cGU9InN0cmluZyI
القيمة الافتراضية https://api.xiaomimimo.com/v1. البيئة: XIAOMI_BASE_URL.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Im1vZGVsIiB0eXBlPSJzdHJpbmci
القيمة الافتراضية mimo-v2.5-tts. البيئة: XIAOMI_TTS_MODEL. يدعم أيضًا mimo-v2-tts وmimo-v2.5-tts-voicedesign.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNwZWFrZXJWb2ljZSIgdHlwZT0ic3RyaW5nIg
القيمة الافتراضية mimo_default لنماذج الصوت المسبق الضبط. البيئة: XIAOMI_TTS_VOICE. الاسم البديل القديم: voice. لا يُرسل لـ mimo-v2.5-tts-voicedesign.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9ImZvcm1hdCIgdHlwZT0nIm1wMyIgfCAid2F2Iic
القيمة الافتراضية mp3. البيئة: XIAOMI_TTS_FORMAT.
OPENCLAW_DOCS_MARKER:paramClose:
OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InN0eWxlIiB0eXBlPSJzdHJpbmci
تعليمة نمط اختيارية بلغة طبيعية تُرسل كرسالة المستخدم؛ لا تُنطق. بالنسبة إلى mimo-v2.5-tts-voicedesign، يكون هذا موجه تصميم الصوت؛ يوفّر OpenClaw قيمة افتراضية عند حذفه.
OPENCLAW_DOCS_MARKER:paramClose:
أداة الوكيل
تحوّل أداة tts النص إلى كلام وتعيد مرفقًا صوتيًا لتسليم الرد.
في Feishu وMatrix وTelegram وWhatsApp، يُسلّم الصوت كرسالة صوتية بدلًا من مرفق ملف. يمكن لـ Feishu وWhatsApp تحويل مخرجات تحويل النص إلى كلام غير Opus في هذا المسار عندما يكون ffmpeg متاحًا.
يرسل WhatsApp الصوت عبر Baileys كملاحظة صوتية PTT (audio مع
ptt: true) ويرسل النص المرئي بشكل منفصل عن صوت PTT لأن
العملاء لا يعرضون التسميات التوضيحية على الملاحظات الصوتية بشكل متسق.
تقبل الأداة حقلي channel وtimeoutMs اختياريًا؛ timeoutMs هو
مهلة طلب المزوّد لكل استدعاء بالمللي ثانية. تتجاوز قيم كل استدعاء
messages.tts.timeoutMs؛ وتتجاوز مُهل تحويل النص إلى كلام المضبوطة أي
قيمة افتراضية للمزوّد كتبها Plugin.
Gateway RPC
| الطريقة | الغرض |
|---|---|
tts.status |
قراءة حالة تحويل النص إلى كلام الحالية وآخر محاولة. |
tts.enable |
تعيين تفضيل التشغيل التلقائي المحلي إلى always. |
tts.disable |
تعيين تفضيل التشغيل التلقائي المحلي إلى off. |
tts.convert |
تحويل نص لمرة واحدة → صوت. |
tts.setProvider |
تعيين تفضيل المزوّد المحلي. |
tts.setPersona |
تعيين تفضيل الشخصية المحلي. |
tts.providers |
سرد المزوّدين المضبوطين وحالاتهم. |
روابط الخدمة
- دليل تحويل النص إلى كلام في OpenAI
- مرجع واجهة برمجة تطبيقات الصوت في OpenAI
- تحويل النص إلى كلام عبر REST في Azure Speech
- مزوّد Azure Speech
- تحويل النص إلى كلام في ElevenLabs
- مصادقة ElevenLabs
- Gradium
- واجهة برمجة تطبيقات تحويل النص إلى كلام في Inworld
- واجهة برمجة تطبيقات MiniMax T2A v2
- واجهة برمجة تطبيقات HTTP لتحويل النص إلى كلام في Volcengine
- تركيب الكلام في Xiaomi MiMo
- node-edge-tts
- تنسيقات مخرجات الكلام في Microsoft
- تحويل النص إلى كلام في xAI