Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 le note vocali) e audio PCM per canali di telefonia come Voice Call. OpenClaw invia richieste all’endpoint TTS in streaming di Inworld, concatena i chunk audio base64 restituiti in un unico buffer e passa il risultato alla pipeline standard dell’audio di risposta.
ProprietàValore
ID providerinworld
Pluginin bundle, enabledByDefault: true
ContrattospeechProviders (solo TTS)
Var env authINWORLD_API_KEY (HTTP Basic, credenziale dashboard Base64)
URL basehttps://api.inworld.ai
Voce predefinitaSarah
Modello predefinitoinworld-tts-1.5-max
UscitaMP3 (predefinita), OGG_OPUS (note vocali), PCM 22050 Hz (telefonia)
Sito webinworld.ai
Documentazionedocs.inworld.ai/tts/tts

Per iniziare

1

Imposta la tua chiave API

Copia la credenziale dalla dashboard Inworld (Workspace > API Keys) e impostala come variabile env. Il valore viene inviato letteralmente 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: {
          voiceId: "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 richiede 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).
voiceIdmessages.tts.providers.inworld.voiceIdIdentificatore 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 letteralmente dalla dashboard Inworld. Il provider la invia come Authorization: Basic <apiKey> senza alcuna ulteriore codifica, quindi non codificarla tu stesso in Base64 e non passare un token in stile bearer. Vedi le note sull’autenticazione TTS per lo stesso richiamo.
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 affinché l’audio venga riprodotto come una bolla vocale nativa. 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

Sintesi vocale

Panoramica TTS, provider e configurazione messages.tts.

Configurazione

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

Provider

Tutti i provider OpenClaw in bundle.

Risoluzione dei problemi

Problemi comuni e passaggi di debug.