Providers

Gradium

Gradium هو مزوّد لتحويل النص إلى كلام في OpenClaw. وهو يُنتج ردودًا صوتية قياسية (WAV)، ومخرجات Opus متوافقة مع الملاحظات الصوتية، وصوت u-law بتردد 8 kHz لواجهات الاتصالات الهاتفية.

الخاصية القيمة
معرّف المزوّد gradium
المصادقة GRADIUM_API_KEY أو إعداد apiKey
عنوان URL الأساسي https://api.gradium.ai (الافتراضي)
الصوت الافتراضي Emma (YTpq7expH9539ERJ)

تثبيت Plugin

Gradium هو Plugin خارجي رسمي. ثبّته، ثم أعد تشغيل Gateway:

bash
openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

الإعداد

أنشئ مفتاح Gradium API، ثم أتحه عبر متغير بيئة أو مفتاح الإعداد. للإعداد أولوية على متغير البيئة.

متغير البيئة

bash
export GRADIUM_API_KEY="gsk_..."

مفتاح الإعداد

json5
{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          apiKey: "${GRADIUM_API_KEY}",        },      },    },  },}

الإعداد

json5
{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          speakerVoiceId: "YTpq7expH9539ERJ",          // apiKey: "${GRADIUM_API_KEY}",          // baseUrl: "https://api.gradium.ai",        },      },    },  },}
المفتاح النوع الوصف
messages.tts.providers.gradium.apiKey سلسلة نصية مفتاح API الذي تم حله. يدعم ${ENV} ومراجع الأسرار.
messages.tts.providers.gradium.baseUrl سلسلة نصية عنوان URL لـ Gradium API عبر HTTPS على api.gradium.ai. تُزال الشرطات المائلة اللاحقة. القيمة الافتراضية https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceId سلسلة نصية معرّف الصوت الافتراضي المستخدم عند عدم وجود تجاوز بتوجيه.

يُختار تنسيق المخرجات تلقائيًا وفقًا للواجهة المستهدفة (راجع المخرجات)، ولا يمكن ضبطه في openclaw.json.

الأصوات

الاسم معرّف الصوت
Arthur 3jUdJyOi9pgbxBTK
Christina 2H4HY2CBNyJHBCrP
Emma (الافتراضي) YTpq7expH9539ERJ
John KWJiFWu2O9nMPYcR
Kent LFZvm12tW_z0xfGo
Sydney jtEKaLYNn6iif5PR
Tiffany Eu9iL_CYe8N-Gkx_

تجاوز الصوت لكل رسالة

عندما تسمح سياسة الكلام النشطة بتجاوزات الصوت، بدّل الأصوات ضمن السطر باستخدام رمز توجيه (جميع الصيغ التالية متكافئة، وتتطلب كلها معرّف صوت أصليًا للمزوّد):

text
/voice:LFZvm12tW_z0xfGo/voice_id:LFZvm12tW_z0xfGo/voiceid:LFZvm12tW_z0xfGo/gradium_voice:LFZvm12tW_z0xfGo/gradiumvoice:LFZvm12tW_z0xfGo

إذا عطّلت سياسة الكلام تجاوزات الصوت، فسيُستهلك التوجيه ولكن سيُتجاهل.

المخرجات

يُحدَّد تنسيق المخرجات بحسب الواجهة المستهدفة؛ ولا يُنشئ المزوّد تنسيقات أخرى.

الهدف التنسيق امتداد الملف معدل أخذ العينات علامة التوافق الصوتي
صوت قياسي wav .wav المزوّد لا
ملاحظة صوتية opus .opus المزوّد نعم
الاتصالات الهاتفية ulaw_8000 غير منطبق 8 kHz غير منطبق

ترتيب الاختيار التلقائي

من بين مزوّدي TTS المضبوطين، ترتيب الاختيار التلقائي لـ Gradium هو 30. راجع تحويل النص إلى كلام لمعرفة كيفية اختيار OpenClaw للمزوّد النشط عندما لا يكون messages.tts.provider مثبّتًا.

ذو صلة

Was this useful?
On this page

On this page