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-speech
openclaw 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 مثبّتًا.

Overview

Concepts and configuration

Providers

تثبيت Plugin

الإعداد

الإعداد

الأصوات

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

المخرجات

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

ذو صلة

​تثبيت Plugin

​الإعداد

​الإعداد

​الأصوات

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

​المخرجات

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

​ذو صلة

تثبيت Plugin

الإعداد

الإعداد

الأصوات

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

المخرجات

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

ذو صلة