Providers

Inworld

Inworld est un fournisseur de synthèse vocale (TTS) en streaming. Dans OpenClaw, il synthétise l’audio des réponses sortantes (MP3 par défaut, OGG_OPUS pour les messages vocaux) ainsi que l’audio PCM brut pour les canaux de téléphonie tels que Voice Call.

OpenClaw envoie les requêtes au point de terminaison TTS en streaming d’Inworld, concatène les fragments audio en base64 renvoyés dans un tampon unique, puis transmet le résultat au pipeline standard de traitement de l’audio des réponses.

Propriété	Valeur
Identifiant du fournisseur	`inworld`
Plugin	paquet externe officiel (`@openclaw/inworld-speech`)
Contrat	`speechProviders` (TTS uniquement)
Variable d’environnement d’authentification	`INWORLD_API_KEY` (HTTP Basic, identifiant du tableau de bord en Base64)
URL de base	`https://api.inworld.ai`
Voix par défaut	`Sarah`
Modèle par défaut	`inworld-tts-1.5-max`
Sortie	MP3 (par défaut), OGG_OPUS (messages vocaux), PCM 22050 Hz (téléphonie)
Site web	inworld.ai
Documentation	docs.inworld.ai/tts/tts

Installer le Plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Prise en main

Définir votre clé d’API

Copiez l’identifiant depuis votre tableau de bord Inworld (Workspace > API Keys) et définissez-le comme variable d’environnement. La valeur est envoyée telle quelle comme identifiant HTTP Basic ; ne l’encodez donc pas à nouveau en Base64 et ne la convertissez pas en jeton Bearer.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Sélectionner Inworld dans messages.tts

json5

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

Envoyer un message

Envoyez une réponse via n’importe quel canal connecté. OpenClaw synthétise l’audio avec Inworld et le transmet au format MP3 (ou OGG_OPUS lorsque le canal attend un message vocal).

Options de configuration

Option	Chemin	Description
`apiKey`	`messages.tts.providers.inworld.apiKey`	Identifiant du tableau de bord en Base64. Utilise `INWORLD_API_KEY` à défaut.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Remplace l’URL de base de l’API Inworld (`https://api.inworld.ai` par défaut).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Identifiant de la voix (`Sarah` par défaut). Ancien alias : `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	Identifiant du modèle TTS (`inworld-tts-1.5-max` par défaut).
`temperature`	`messages.tts.providers.inworld.temperature`	Température d’échantillonnage, de `0` (exclu) à `2` (facultatif).

Remarques

Authentification

Inworld utilise l’authentification HTTP Basic avec une chaîne d’identification unique encodée en Base64. Copiez-la telle quelle depuis le tableau de bord Inworld. Le fournisseur l’envoie sous la forme Authorization: Basic <apiKey> sans aucun encodage supplémentaire ; ne l’encodez donc pas vous-même en Base64 et ne transmettez pas de jeton de type Bearer. Consultez les remarques sur l’authentification TTS pour retrouver le même avertissement.

Modèles

Identifiants de modèles pris en charge : inworld-tts-1.5-max (par défaut), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Sorties audio

Les réponses utilisent le format MP3 par défaut. Lorsque la cible du canal est voice-note, OpenClaw demande le format OGG_OPUS à Inworld afin que l’audio soit lu comme une bulle vocale native. La synthèse pour la téléphonie utilise du PCM brut à 22050 Hz pour alimenter la passerelle de téléphonie.

Points de terminaison personnalisés

Remplacez l’hôte de l’API avec messages.tts.providers.inworld.baseUrl. Les barres obliques finales sont supprimées avant l’envoi des requêtes.