الانتقال إلى المحتوى الرئيسي
Inworld هو موفّر تحويل النص إلى كلام (TTS) بالبث. في OpenClaw يُنشئ صوت الردود الصادرة (MP3 افتراضيًا، وOGG_OPUS للملاحظات الصوتية) وصوت PCM لقنوات الهاتف مثل المكالمة الصوتية. يرسل OpenClaw الطلبات إلى نقطة نهاية TTS بالبث الخاصة بـ Inworld، ويدمج مقاطع الصوت المرجعة بترميز base64 في مخزن مؤقت واحد، ثم يمرّر النتيجة إلى مسار صوت الرد القياسي.
الخاصيةالقيمة
معرّف الموفّرinworld
Pluginحزمة خارجية رسمية
العقدspeechProviders (TTS فقط)
متغير بيئة المصادقةINWORLD_API_KEY (HTTP Basic، بيانات اعتماد لوحة التحكم بصيغة Base64)
عنوان URL الأساسيhttps://api.inworld.ai
الصوت الافتراضيSarah
النموذج الافتراضيinworld-tts-1.5-max
المخرجاتMP3 (افتراضي)، OGG_OPUS (ملاحظات صوتية)، PCM 22050 Hz (الهاتف)
الموقعinworld.ai
الوثائقdocs.inworld.ai/tts/tts

​
تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway: 
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
البدء

1

اضبط مفتاح API الخاص بك

انسخ بيانات الاعتماد من لوحة تحكم Inworld (Workspace > API Keys) واضبطها كمتغير بيئة. تُرسل القيمة كما هي بوصفها بيانات اعتماد HTTP Basic، لذلك لا ترمّزها بصيغة Base64 مرة أخرى ولا تحوّلها إلى رمز bearer.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

اختر Inworld في messages.tts

{
  messages: {
    tts: {
      auto: "always",
      provider: "inworld",
      providers: {
        inworld: {
          speakerVoiceId: "Sarah",
          modelId: "inworld-tts-1.5-max",
        },
      },
    },
  },
}
3

أرسل رسالة

أرسل ردًا عبر أي قناة متصلة. يُنشئ OpenClaw الصوت باستخدام Inworld ويوصله بصيغة MP3 (أو OGG_OPUS عندما تتوقع القناة ملاحظة صوتية).

​
خيارات التكوين

الخيارالمسارالوصف
apiKeymessages.tts.providers.inworld.apiKeyبيانات اعتماد لوحة التحكم بصيغة Base64. يرجع إلى INWORLD_API_KEY.
baseUrlmessages.tts.providers.inworld.baseUrlتجاوز عنوان URL الأساسي لـ API الخاص بـ Inworld (الافتراضي https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdمعرّف الصوت (الافتراضي Sarah).
modelIdmessages.tts.providers.inworld.modelIdمعرّف نموذج TTS (الافتراضي inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureدرجة حرارة أخذ العينات 0..2 (اختياري).

​
ملاحظات

يستخدم Inworld مصادقة HTTP Basic بسلسلة بيانات اعتماد واحدة مرمّزة بصيغة Base64. انسخها كما هي من لوحة تحكم Inworld. يرسلها الموفّر بصيغة Authorization: Basic <apiKey> دون أي ترميز إضافي، لذلك لا ترمّزها بنفسك بصيغة Base64 ولا تمرّر رمزًا بنمط bearer. راجع ملاحظات مصادقة TTS للاطلاع على التنبيه نفسه.
معرّفات النماذج المدعومة: inworld-tts-1.5-max (افتراضي)، inworld-tts-1.5-mini، inworld-tts-1-max، inworld-tts-1.
تستخدم الردود MP3 افتراضيًا. عندما يكون هدف القناة هو voice-note يطلب OpenClaw من Inworld استخدام OGG_OPUS حتى يُشغّل الصوت كفقاعة صوتية أصلية. يستخدم إنشاء الصوت للهاتف PCM خامًا عند 22050 Hz لتغذية جسر الهاتف.
تجاوز مضيف API باستخدام messages.tts.providers.inworld.baseUrl. تُزال الشرطات المائلة اللاحقة قبل إرسال الطلبات.

​
ذات صلة

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

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

التكوين

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

الموفّرون

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

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

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