Vai al contenuto principale
Inworld è un provider di sintesi vocale text-to-speech (TTS) in streaming. In OpenClaw sintetizza l’audio delle risposte in uscita (MP3 per impostazione predefinita, OGG_OPUS per le note vocali) e audio PCM per canali telefonici come Voice Call. OpenClaw invia richieste all’endpoint TTS in streaming di Inworld, concatena i chunk audio base64 restituiti in un singolo buffer e passa il risultato alla pipeline standard per l’audio di risposta.
ProprietàValore
ID providerinworld
Pluginpacchetto esterno ufficiale
ContrattospeechProviders (solo TTS)
Variabile env di autenticazioneINWORLD_API_KEY (HTTP Basic, credenziale dashboard Base64)
URL basehttps://api.inworld.ai
Voce predefinitaSarah
Modello predefinitoinworld-tts-1.5-max
OutputMP3 (predefinito), OGG_OPUS (note vocali), PCM 22050 Hz (telefonia)
Sito webinworld.ai
Documentazionedocs.inworld.ai/tts/tts

​
Installa il Plugin

Installa il Plugin ufficiale, poi riavvia Gateway: 
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
Primi passi

1

Imposta la tua chiave API

Copia la credenziale dalla tua dashboard Inworld (Workspace > API Keys) e impostala come variabile env. Il valore viene inviato così com’è come credenziale HTTP Basic, quindi non codificarlo di nuovo in Base64 né convertirlo in un token bearer.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Seleziona Inworld in messages.tts

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

Invia un messaggio

Invia una risposta tramite qualsiasi canale connesso. OpenClaw sintetizza l’audio con Inworld e lo consegna come MP3 (o OGG_OPUS quando il canale si aspetta una nota vocale).

​
Opzioni di configurazione

OpzionePercorsoDescrizione
apiKeymessages.tts.providers.inworld.apiKeyCredenziale dashboard Base64. Ripiega su INWORLD_API_KEY.
baseUrlmessages.tts.providers.inworld.baseUrlSovrascrive l’URL base dell’API Inworld (predefinito https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdIdentificatore della voce (predefinito Sarah).
modelIdmessages.tts.providers.inworld.modelIdID modello TTS (predefinito inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureTemperatura di campionamento 0..2 (opzionale).

​
Note

Inworld usa l’autenticazione HTTP Basic con una singola stringa di credenziale codificata in Base64. Copiala così com’è dalla dashboard Inworld. Il provider la invia come Authorization: Basic <apiKey> senza ulteriori codifiche, quindi non codificarla tu in Base64 e non passare un token in stile bearer. Vedi le note di autenticazione TTS per la stessa avvertenza.
ID modello supportati: inworld-tts-1.5-max (predefinito), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
Le risposte usano MP3 per impostazione predefinita. Quando il target del canale è voice-note, OpenClaw chiede a Inworld OGG_OPUS così l’audio viene riprodotto come fumetto vocale nativo. La sintesi per telefonia usa PCM grezzo a 22050 Hz per alimentare il bridge di telefonia.
Sovrascrivi l’host API con messages.tts.providers.inworld.baseUrl. Le barre finali vengono rimosse prima dell’invio delle richieste.

​
Correlati

Text-to-speech

Panoramica TTS, provider e configurazione messages.tts.

Configurazione

Riferimento completo della configurazione, incluse le impostazioni messages.tts.

Provider

Tutti i provider OpenClaw supportati.

Risoluzione dei problemi

Problemi comuni e passaggi di debug.