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:
openclaw plugins install @openclaw/gradium-speechopenclaw gateway restartالإعداد
أنشئ مفتاح Gradium API، ثم أتحه عبر متغير بيئة أو مفتاح الإعداد. للإعداد أولوية على متغير البيئة.
متغير البيئة
export GRADIUM_API_KEY="gsk_..."مفتاح الإعداد
{ messages: { tts: { auto: "always", provider: "gradium", providers: { gradium: { apiKey: "${GRADIUM_API_KEY}", }, }, }, },}الإعداد
{ 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_ |
تجاوز الصوت لكل رسالة
عندما تسمح سياسة الكلام النشطة بتجاوزات الصوت، بدّل الأصوات ضمن السطر باستخدام رمز توجيه (جميع الصيغ التالية متكافئة، وتتطلب كلها معرّف صوت أصليًا للمزوّد):
/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 مثبّتًا.