الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Inworld هو مزوّد تحويل النص إلى كلام (TTS) بالبث. في OpenClaw، يقوم بتوليف صوت الردود الصادرة (MP3 افتراضيًا، وOGG_OPUS للملاحظات الصوتية) وصوت PCM لقنوات الاتصالات الهاتفية مثل المكالمة الصوتية. ينشر OpenClaw إلى نقطة نهاية TTS بالبث الخاصة بـ Inworld، ويجمع مقاطع الصوت المرجعة بترميز base64 في مخزن مؤقت واحد، ثم يمرر النتيجة إلى مسار صوت الرد القياسي.
الخاصيةالقيمة
معرّف المزوّدinworld
Pluginمضمن، enabledByDefault: true
العقد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

​
البدء

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: {
          voiceId: "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).
voiceIdmessages.tts.providers.inworld.voiceIdمعرّف الصوت (الافتراضي 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 المضمنين.

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

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