Gradium

Gradium est un fournisseur de synthèse vocale pour OpenClaw. Il produit des réponses audio standard (WAV), une sortie Opus compatible avec les messages vocaux et un flux audio u-law à 8 kHz pour les interfaces de téléphonie.

Propriété	Valeur
Identifiant du fournisseur	`gradium`
Authentification	`GRADIUM_API_KEY` ou configuration `apiKey`
URL de base	`https://api.gradium.ai` (par défaut)
Voix par défaut	`Emma` (`YTpq7expH9539ERJ`)

Installer le plugin

Gradium est un plugin externe officiel. Installez-le, puis redémarrez le Gateway :

openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

Configuration initiale

Créez une clé API Gradium, puis exposez-la au moyen d’une variable d’environnement ou de la clé de configuration. La configuration est prioritaire sur la variable d’environnement.

Variable d’environnement
Clé de configuration

export GRADIUM_API_KEY="gsk_..."

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          apiKey: "${GRADIUM_API_KEY}",
        },
      },
    },
  },
}

Configuration

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}

Clé	Type	Description
`messages.tts.providers.gradium.apiKey`	chaîne	Clé API résolue. Prend en charge `${ENV}` et les références de secrets.
`messages.tts.providers.gradium.baseUrl`	chaîne	URL HTTPS de l’API Gradium sur `api.gradium.ai`. Les barres obliques finales sont supprimées. Valeur par défaut : `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	chaîne	Identifiant de voix par défaut utilisé lorsqu’aucune directive de remplacement n’est présente.

Le format de sortie est choisi automatiquement selon l’interface cible (voir Sortie) et n’est pas configurable dans openclaw.json.

Voix

Nom	Identifiant de voix
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (par défaut)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

Remplacement de la voix par message

Lorsque la politique de synthèse vocale active autorise le remplacement de la voix, changez de voix directement dans le message à l’aide d’un jeton de directive (toutes les formes suivantes sont équivalentes et acceptent un identifiant de voix natif du fournisseur) :

/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo

Si la politique de synthèse vocale désactive le remplacement de la voix, la directive est consommée, mais ignorée.

Sortie

Le format de sortie est sélectionné selon l’interface cible ; le fournisseur ne synthétise pas d’autres formats.

Cible	Format	Extension de fichier	Fréquence d’échantillonnage	Indicateur de compatibilité vocale
Audio standard	`wav`	`.wav`	fournisseur	non
Message vocal	`opus`	`.opus`	fournisseur	oui
Téléphonie	`ulaw_8000`	s.o.	8 kHz	s.o.

Ordre de sélection automatique

Parmi les fournisseurs de synthèse vocale configurés, l’ordre de sélection automatique de Gradium est 30. Consultez Synthèse vocale pour savoir comment OpenClaw choisit le fournisseur actif lorsque messages.tts.provider n’est pas défini explicitement.

Overview

Concepts and configuration

Providers

Installer le plugin

Configuration initiale

Configuration

Voix

Remplacement de la voix par message

Sortie

Ordre de sélection automatique

Pages connexes

​Installer le plugin

​Configuration initiale

​Configuration

​Voix

​Remplacement de la voix par message

​Sortie

​Ordre de sélection automatique

​Pages connexes

Installer le plugin

Configuration initiale

Configuration

Voix

Remplacement de la voix par message

Sortie

Ordre de sélection automatique

Pages connexes