Providers

Inworld

Inworld, akışlı bir metinden konuşmaya (TTS) sağlayıcısıdır. OpenClaw'da giden yanıt sesini (varsayılan olarak MP3, sesli notlar için OGG_OPUS) ve Voice Call gibi telefon kanalları için ham PCM sesini sentezler.

OpenClaw, Inworld'ün akışlı TTS uç noktasına istek gönderir, döndürülen base64 ses parçalarını tek bir arabellekte birleştirir ve sonucu standart yanıt sesi işlem hattına aktarır.

Özellik	Değer
Sağlayıcı kimliği	`inworld`
Plugin	resmî harici paket (`@openclaw/inworld-speech`)
Sözleşme	`speechProviders` (yalnızca TTS)
Kimlik doğrulama ortam değişkeni	`INWORLD_API_KEY` (HTTP Basic, Base64 pano kimlik bilgisi)
Temel URL	`https://api.inworld.ai`
Varsayılan ses	`Sarah`
Varsayılan model	`inworld-tts-1.5-max`
Çıktı	MP3 (varsayılan), OGG_OPUS (sesli notlar), PCM 22050 Hz (telefon)
Web sitesi	inworld.ai
Belgeler	docs.inworld.ai/tts/tts

Plugin'i yükleme

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Başlarken

API anahtarınızı ayarlayın

Kimlik bilgisini Inworld panonuzdan (Workspace > API Keys) kopyalayın ve ortam değişkeni olarak ayarlayın. Değer, HTTP Basic kimlik bilgisi olarak olduğu gibi gönderilir; bu nedenle yeniden Base64 ile kodlamayın veya bearer token'a dönüştürmeyin.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

tts içinde Inworld'ü seçin

json5

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

Mesaj gönderin

Bağlı herhangi bir kanal üzerinden yanıt gönderin. OpenClaw, sesi Inworld ile sentezler ve MP3 olarak (veya kanal sesli not beklediğinde OGG_OPUS olarak) iletir.

Yapılandırma seçenekleri

Seçenek	Yol	Açıklama
`apiKey`	`tts.providers.inworld.apiKey`	Base64 pano kimlik bilgisi. `INWORLD_API_KEY` değerine geri döner.
`baseUrl`	`tts.providers.inworld.baseUrl`	Inworld API temel URL'sini geçersiz kılar (varsayılan `https://api.inworld.ai`).
`voiceId`	`tts.providers.inworld.voiceId`	Ses tanımlayıcısı (varsayılan `Sarah`). Eski diğer ad: `speakerVoiceId`.
`modelId`	`tts.providers.inworld.modelId`	TTS model kimliği (varsayılan `inworld-tts-1.5-max`).
`temperature`	`tts.providers.inworld.temperature`	Örnekleme sıcaklığı, `0` (hariç) ile `2` arasında (isteğe bağlı).

Notlar

Kimlik doğrulama

Inworld, Base64 ile kodlanmış tek bir kimlik bilgisi dizesiyle HTTP Basic kimlik doğrulaması kullanır. Bunu Inworld panosundan olduğu gibi kopyalayın. Sağlayıcı, herhangi bir ek kodlama yapmadan bunu Authorization: Basic <apiKey> olarak gönderir; bu nedenle kendiniz Base64 ile kodlamayın ve bearer tarzı bir token iletmeyin. Aynı uyarı için TTS kimlik doğrulama notlarına bakın.

Modeller

Desteklenen model kimlikleri: inworld-tts-1.5-max (varsayılan), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Ses çıktıları

Yanıtlar varsayılan olarak MP3 kullanır. Kanal hedefi voice-note olduğunda OpenClaw, sesin yerel bir ses balonu olarak oynatılması için Inworld'den OGG_OPUS ister. Telefon sentezi, telefon köprüsünü beslemek için 22050 Hz'de ham PCM kullanır.

Özel uç noktalar

tts.providers.inworld.baseUrl ile API ana makinesini geçersiz kılın. İstekler gönderilmeden önce sondaki eğik çizgiler kaldırılır.