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

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

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

عيّن مفتاح API

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

INWORLD_API_KEY=<base64-credential-from-dashboard>

حدّد Inworld في messages.tts

{
  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. تُزال الشرطات المائلة اللاحقة قبل إرسال الطلبات.

ذو صلة

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

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

الإعداد

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

الموفّرون

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

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

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

Overview

Concepts and configuration

Providers

تثبيت Plugin

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

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

ملاحظات

ذو صلة

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

الإعداد

الموفّرون

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

​تثبيت Plugin

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

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

​ملاحظات

​ذو صلة

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

الإعداد

الموفّرون

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

تثبيت Plugin

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

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

ملاحظات

ذو صلة