In questa pagina
In questa pagina
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
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.
Seleziona Inworld in messages.tts
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.
