Ana içeriğe atla
Inworld, akış tabanlı bir metinden konuşmaya (TTS) sağlayıcısıdır. OpenClaw içinde giden yanıt sesini (varsayılan olarak MP3, sesli notlar için OGG_OPUS) ve Voice Call gibi telefon kanalları için PCM sesi sentezler. OpenClaw, Inworld’ün akış tabanlı TTS uç noktasına gönderim yapar, dönen base64 ses parçalarını tek bir arabellek halinde birleştirir ve sonucu standart yanıt-sesi işlem hattına verir.
ÖzellikDeğer
Sağlayıcı kimliğiinworld
Pluginresmi harici paket
SözleşmespeechProviders (yalnızca TTS)
Kimlik doğrulama ortam değişkeniINWORLD_API_KEY (HTTP Basic, Base64 pano kimlik bilgisi)
Temel URLhttps://api.inworld.ai
Varsayılan sesSarah
Varsayılan modelinworld-tts-1.5-max
ÇıktıMP3 (varsayılan), OGG_OPUS (sesli notlar), PCM 22050 Hz (telefon)
Web sitesiinworld.ai
Belgelerdocs.inworld.ai/tts/tts

Plugin yükle

Resmi Plugin’i yükleyin, ardından Gateway’i yeniden başlatın:
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

Başlarken

1

API anahtarınızı ayarlayın

Kimlik bilgisini Inworld panonuzdan (Workspace > API Keys) kopyalayın ve bir ortam değişkeni olarak ayarlayın. Değer, HTTP Basic kimlik bilgisi olarak aynen gönderilir; bu yüzden yeniden Base64 ile kodlamayın veya bearer belirtecine dönüştürmeyin.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

messages.tts içinde Inworld'ü seçin

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

Bir mesaj gönderin

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

Yapılandırma seçenekleri

SeçenekYolAçıklama
apiKeymessages.tts.providers.inworld.apiKeyBase64 pano kimlik bilgisi. INWORLD_API_KEY değerine geri döner.
baseUrlmessages.tts.providers.inworld.baseUrlInworld API temel URL’sini geçersiz kılar (varsayılan https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdSes tanımlayıcısı (varsayılan Sarah).
modelIdmessages.tts.providers.inworld.modelIdTTS model kimliği (varsayılan inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureÖrnekleme sıcaklığı 0..2 (isteğe bağlı).

Notlar

Inworld, tek bir Base64 ile kodlanmış kimlik bilgisi dizesiyle HTTP Basic kimlik doğrulaması kullanır. Bunu Inworld panosundan aynen kopyalayın. Sağlayıcı bunu ek kodlama yapmadan Authorization: Basic <apiKey> olarak gönderir; bu yüzden kendiniz Base64 ile kodlamayın ve bearer tarzı bir belirteç geçirmeyin. Aynı uyarı için TTS kimlik doğrulama notları bölümüne bakın.
Desteklenen model kimlikleri: inworld-tts-1.5-max (varsayılan), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
Yanıtlar varsayılan olarak MP3 kullanır. Kanal hedefi voice-note olduğunda OpenClaw, sesin yerel bir ses balonu olarak çalması için Inworld’den OGG_OPUS ister. Telefon sentezi, telefon köprüsünü beslemek için 22050 Hz’de ham PCM kullanır.
API ana makinesini messages.tts.providers.inworld.baseUrl ile geçersiz kılın. Sondaki eğik çizgiler istekler gönderilmeden önce kaldırılır.

İlgili

Metinden konuşmaya

TTS genel bakışı, sağlayıcılar ve messages.tts yapılandırması.

Yapılandırma

messages.tts ayarları dahil tam yapılandırma başvurusu.

Sağlayıcılar

Desteklenen tüm OpenClaw sağlayıcıları.

Sorun giderme

Yaygın sorunlar ve hata ayıklama adımları.