Providers

Inworld

Inworld هو موفّر لتحويل النص إلى كلام (TTS) عبر البث. في OpenClaw، يُنشئ صوت الردود الصادرة (MP3 افتراضيًا، وOGG_OPUS للملاحظات الصوتية) وصوت PCM خامًا لقنوات الاتصالات الهاتفية مثل Voice Call.

يرسل OpenClaw طلبات POST إلى نقطة نهاية TTS المتدفقة في Inworld، ويدمج مقاطع الصوت المُعادة والمشفّرة بصيغة base64 في مخزن مؤقت واحد، ثم يمرّر النتيجة إلى مسار معالجة صوت الرد القياسي.

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

تثبيت Plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

بدء الاستخدام

عيّن مفتاح API

انسخ بيانات الاعتماد من لوحة تحكم Inworld ‏(Workspace > API Keys) وعيّنها كمتغيّر بيئة. تُرسل القيمة حرفيًا بوصفها بيانات اعتماد HTTP Basic، لذا لا تُشفّرها مجددًا بصيغة Base64 ولا تحوّلها إلى رمز حامل.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

حدّد Inworld في messages.tts

json5

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

أرسل رسالة

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

خيارات الإعداد

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

ملاحظات

المصادقة

يستخدم Inworld مصادقة HTTP Basic بسلسلة بيانات اعتماد واحدة مشفّرة بصيغة Base64. انسخها حرفيًا من لوحة تحكم Inworld. يرسلها الموفّر بالشكل Authorization: Basic <apiKey> من دون أي تشفير إضافي، لذا لا تُشفّرها بنفسك بصيغة Base64 ولا تمرّر رمزًا بنمط الحامل. راجع ملاحظات مصادقة 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 هرتز لتغذية جسر الاتصالات الهاتفية.

نقاط النهاية المخصصة

تجاوز مضيف API باستخدام messages.tts.providers.inworld.baseUrl. تُزال الشرطات المائلة اللاحقة قبل إرسال الطلبات.