Providers

Inworld

Inworld è un provider di sintesi vocale (TTS) in streaming. In OpenClaw sintetizza l'audio delle risposte in uscita (MP3 per impostazione predefinita, OGG_OPUS per i messaggi vocali) e audio PCM grezzo per i canali di telefonia come Voice Call.

OpenClaw invia richieste all'endpoint TTS in streaming di Inworld, concatena i segmenti audio in base64 restituiti in un singolo buffer e passa il risultato alla pipeline standard per l'audio delle risposte.

Proprietà	Valore
ID provider	`inworld`
Plugin	pacchetto esterno ufficiale (`@openclaw/inworld-speech`)
Contratto	`speechProviders` (solo TTS)
Variabile di ambiente per l'autenticazione	`INWORLD_API_KEY` (HTTP Basic, credenziale Base64 della dashboard)
URL di base	`https://api.inworld.ai`
Voce predefinita	`Sarah`
Modello predefinito	`inworld-tts-1.5-max`
Output	MP3 (predefinito), OGG_OPUS (messaggi vocali), PCM 22050 Hz (telefonia)
Sito web	inworld.ai
Documentazione	docs.inworld.ai/tts/tts

Installare il Plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Guida introduttiva

Imposta la chiave API

Copia la credenziale dalla dashboard di Inworld (Workspace > API Keys) e impostala come variabile di ambiente. Il valore viene inviato senza modifiche come credenziale HTTP Basic, quindi non codificarlo nuovamente in Base64 e non convertirlo in un token bearer.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Seleziona Inworld in messages.tts

json5

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

Invia un messaggio

Invia una risposta tramite qualsiasi canale connesso. OpenClaw sintetizza l'audio con Inworld e lo recapita come MP3 (o OGG_OPUS quando il canale richiede un messaggio vocale).

Opzioni di configurazione

Opzione	Percorso	Descrizione
`apiKey`	`messages.tts.providers.inworld.apiKey`	Credenziale Base64 della dashboard. In alternativa usa `INWORLD_API_KEY`.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Sostituisce l'URL di base dell'API Inworld (predefinito: `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Identificatore della voce (predefinito: `Sarah`). Alias precedente: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	ID del modello TTS (predefinito: `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	Temperatura di campionamento, da `0` (escluso) a `2` (facoltativa).

Note

Autenticazione

Inworld usa l'autenticazione HTTP Basic con un'unica stringa di credenziali codificata in Base64. Copiala senza modifiche dalla dashboard di Inworld. Il provider la invia come Authorization: Basic <apiKey> senza ulteriore codifica, quindi non codificarla personalmente in Base64 e non fornire un token in stile bearer. Consulta le note sull'autenticazione TTS per la stessa avvertenza.

Modelli

ID dei modelli supportati: inworld-tts-1.5-max (predefinito), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Formati audio in uscita

Per impostazione predefinita, le risposte usano MP3. Quando la destinazione del canale è voice-note, OpenClaw richiede a Inworld il formato OGG_OPUS, così l'audio viene riprodotto come messaggio vocale nativo. La sintesi per telefonia usa audio PCM grezzo a 22050 Hz per alimentare il bridge di telefonia.

Endpoint personalizzati

Sostituisci l'host dell'API con messages.tts.providers.inworld.baseUrl. Le barre finali vengono rimosse prima dell'invio delle richieste.