Gradium - OpenClaw

Gradium est un fournisseur de synthèse vocale intégré à OpenClaw. Le Plugin peut générer des réponses audio normales (WAV), une sortie Opus compatible avec les notes vocales et de l’audio u-law à 8 kHz pour les surfaces de téléphonie.

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

Mise en place

Créez une clé d’API Gradium, puis exposez-la à OpenClaw avec une variable d’environnement ou la clé de configuration.

Env var
Config key

export GRADIUM_API_KEY="gsk_..."

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

Le Plugin vérifie d’abord l’apiKey résolue, puis se rabat sur la variable d’environnement GRADIUM_API_KEY.

Configuration

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

Clé	Type	Description
`messages.tts.providers.gradium.apiKey`	string	Clé d’API résolue. Prend en charge `${ENV}` et les références secrètes.
`messages.tts.providers.gradium.baseUrl`	string	Remplace l’origine de l’API. Les barres obliques finales sont supprimées. Valeur par défaut : `https://api.gradium.ai`.
`messages.tts.providers.gradium.voiceId`	string	ID de voix par défaut utilisé lorsqu’aucune directive de remplacement n’est présente.

Le format audio de sortie est sélectionné automatiquement par le runtime en fonction de la surface cible et n’est pas configurable depuis openclaw.json. Voir Sortie ci-dessous.

Voix

Nom	ID de voix
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
Tiffany	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
Sydney	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

Voix par défaut : Emma.

Remplacement de voix par message

Lorsque la politique vocale active autorise les remplacements de voix, vous pouvez changer de voix en ligne à l’aide d’un jeton de directive. Tous ceux-ci se résolvent vers le même remplacement de voiceId :

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

Si la politique vocale désactive les remplacements de voix, la directive est consommée mais ignorée.

Sortie

Le runtime choisit le format de sortie à partir de la surface cible. Le fournisseur ne synthétise pas d’autres formats aujourd’hui.

Cible	Format	Extension de fichier	Fréquence d’échantillonnage	Indicateur compatible voix
Audio standard	`wav`	`.wav`	fournisseur	non
Note vocale	`opus`	`.opus`	fournisseur	oui
Téléphonie	`ulaw_8000`	n/a	8 kHz	n/a

Ordre de sélection automatique

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

Documentation Index

​Mise en place

​Configuration

​Voix

​Remplacement de voix par message

​Sortie

​Ordre de sélection automatique

​Connexe