Azure Speech - OpenClaw

Azure Speech هو موفّر تحويل النص إلى كلام من Azure AI Speech. في OpenClaw، يقوم بتوليف صوت الردود الصادرة بصيغة MP3 افتراضيًا، وOgg/Opus الأصلي للرسائل الصوتية، وصوت mulaw بتردد 8 كيلوهرتز لقنوات الهاتف مثل المكالمات الصوتية. يستخدم OpenClaw واجهة Azure Speech REST API مباشرةً مع SSML ويرسل تنسيق الإخراج المملوك للموفّر عبر X-Microsoft-OutputFormat.

التفاصيل	القيمة
الموقع الإلكتروني	Azure AI Speech
الوثائق	Speech REST text-to-speech
المصادقة	`AZURE_SPEECH_KEY` بالإضافة إلى `AZURE_SPEECH_REGION`
الصوت الافتراضي	`en-US-JennyNeural`
إخراج الملف الافتراضي	`audio-24khz-48kbitrate-mono-mp3`
ملف الرسالة الصوتية الافتراضي	`ogg-24khz-16bit-mono-opus`

البدء

أنشئ مورد Azure Speech

في مدخل Azure، أنشئ مورد Speech. انسخ KEY 1 من Resource Management > Keys and Endpoint، وانسخ موقع المورد مثل eastus.

AZURE_SPEECH_KEY=<speech-resource-key>
AZURE_SPEECH_REGION=eastus

اختر Azure Speech في messages.tts

{
  messages: {
    tts: {
      auto: "always",
      provider: "azure-speech",
      providers: {
        "azure-speech": {
          speakerVoice: "en-US-JennyNeural",
          lang: "en-US",
        },
      },
    },
  },
}

أرسل رسالة

أرسل ردًا عبر أي قناة متصلة. يقوم OpenClaw بتوليف الصوت باستخدام Azure Speech ويوصل MP3 للصوت القياسي، أو Ogg/Opus عندما تتوقع القناة رسالة صوتية.

خيارات الإعداد

الخيار	المسار	الوصف
`apiKey`	`messages.tts.providers.azure-speech.apiKey`	مفتاح مورد Azure Speech. يعود احتياطيًا إلى `AZURE_SPEECH_KEY` أو `AZURE_SPEECH_API_KEY` أو `SPEECH_KEY`.
`region`	`messages.tts.providers.azure-speech.region`	منطقة مورد Azure Speech. يعود احتياطيًا إلى `AZURE_SPEECH_REGION` أو `SPEECH_REGION`.
`endpoint`	`messages.tts.providers.azure-speech.endpoint`	تجاوز اختياري لنقطة نهاية/عنوان URL الأساسي لـ Azure Speech.
`baseUrl`	`messages.tts.providers.azure-speech.baseUrl`	تجاوز اختياري لعنوان URL الأساسي لـ Azure Speech.
`speakerVoice`	`messages.tts.providers.azure-speech.speakerVoice`	ShortName لصوت Azure (الافتراضي `en-US-JennyNeural`). الاسم المستعار القديم: `voice`.
`lang`	`messages.tts.providers.azure-speech.lang`	رمز لغة SSML (الافتراضي `en-US`).
`outputFormat`	`messages.tts.providers.azure-speech.outputFormat`	تنسيق إخراج ملف الصوت (الافتراضي `audio-24khz-48kbitrate-mono-mp3`).
`voiceNoteOutputFormat`	`messages.tts.providers.azure-speech.voiceNoteOutputFormat`	تنسيق إخراج الرسالة الصوتية (الافتراضي `ogg-24khz-16bit-mono-opus`).

ملاحظات

المصادقة

يستخدم Azure Speech مفتاح مورد Speech، وليس مفتاح Azure OpenAI. يُرسل المفتاح كـ Ocp-Apim-Subscription-Key؛ ويشتق OpenClaw https://<region>.tts.speech.microsoft.com من region ما لم توفّر endpoint أو baseUrl.

أسماء الأصوات

استخدم قيمة ShortName لصوت Azure Speech، على سبيل المثال en-US-JennyNeural. يستطيع الموفّر المضمن سرد الأصوات عبر مورد Speech نفسه وتصفية الأصوات المعلّمة كمهملة أو متقاعدة.

مخرجات الصوت

يقبل Azure تنسيقات إخراج مثل audio-24khz-48kbitrate-mono-mp3، وogg-24khz-16bit-mono-opus، وriff-24khz-16bit-mono-pcm. يطلب OpenClaw Ogg/Opus لأهداف voice-note حتى تتمكن القنوات من إرسال فقاعات صوتية أصلية دون تحويل إضافي إلى MP3.

الاسم المستعار

يُقبل azure كاسم مستعار للموفّر لطلبات PR الحالية وإعدادات المستخدم، لكن يجب أن تستخدم الإعدادات الجديدة azure-speech لتجنب الالتباس مع موفّري نماذج Azure OpenAI.

تحويل النص إلى كلام

نظرة عامة على TTS والموفّرين وإعداد messages.tts.

الإعداد

مرجع الإعداد الكامل بما في ذلك إعدادات messages.tts.

الموفّرون

جميع موفّري OpenClaw المضمنين.

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة وخطوات التصحيح.

​البدء

​خيارات الإعداد

​ملاحظات

​ذات صلة