Gradium - OpenClaw

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

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

تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:

openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

الإعداد

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

Env var
Config key

export GRADIUM_API_KEY="gsk_..."

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

يتحقق Plugin أولاً من 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`	string	مفتاح API المحلول. يدعم `${ENV}` ومراجع الأسرار.
`messages.tts.providers.gradium.baseUrl`	string	يتجاوز أصل API. تُزال الشرطات المائلة اللاحقة. القيمة الافتراضية هي `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	معرّف الصوت الافتراضي المستخدم عند عدم وجود تجاوز بتوجيه.

يُختار تنسيق الصوت الناتج تلقائياً بواسطة وقت التشغيل استناداً إلى الواجهة المستهدفة، ولا يمكن ضبطه من openclaw.json. راجع المخرجات أدناه.

الأصوات

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

الصوت الافتراضي: Emma.

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

عندما تسمح سياسة الكلام النشطة بتجاوزات الصوت، يمكنك تبديل الأصوات ضمن النص باستخدام رمز توجيه. استخدم speakerVoiceId لمعرّفات الصوت الأصلية لدى المزوّد.

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

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

المخرجات

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

الهدف	التنسيق	امتداد الملف	معدل العينة	علم التوافق الصوتي
صوت قياسي	`wav`	`.wav`	المزوّد	لا
ملاحظة صوتية	`opus`	`.opus`	المزوّد	نعم
اتصال هاتفي	`ulaw_8000`	غير متاح	8 كيلوهرتز	غير متاح

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

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

​تثبيت Plugin

​الإعداد

​الإعدادات

​الأصوات

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

​المخرجات

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

​ذو صلة