Gradium - OpenClaw

Gradium est un fournisseur de synthèse vocale pour OpenClaw. Le plugin peut produire 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`)

Installer le plugin

Installez le plugin officiel, puis redémarrez Gateway :

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

Configuration

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 et se rabat sur la variable d’environnement GRADIUM_API_KEY.

Config

{
  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`	string	Clé d’API résolue. Prend en charge `${ENV}` et les références de secrets.
`messages.tts.providers.gradium.baseUrl`	string	Remplace l’origine de l’API. Les barres obliques finales sont supprimées. Par défaut : `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	ID de voix par défaut utilisé quand 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 la voix par message

Quand la politique de synthèse vocale active autorise les remplacements de voix, vous pouvez changer de voix en ligne avec un jeton de directive. Utilisez speakerVoiceId pour les ID de voix natifs 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 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 défini explicitement.

​Installer le plugin

​Configuration

​Config

​Voix

​Remplacement de la voix par message

​Sortie

​Ordre de sélection automatique

​Associés