> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gradium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> Utilisez la synthèse vocale Gradium dans les agents OpenClaw

OpenClaw est une passerelle d'agents auto-hébergée pour les canaux de messagerie, les sessions d'agents et les workflows pilotés par des outils. Son fournisseur vocal Gradium intégré permet aux agents OpenClaw de convertir leurs réponses en audio, en sortie Opus compatible avec les messages vocaux, ou en audio u-law 8 kHz pour la téléphonie.

<CardGroup cols={2}>
  <Card title="Fournisseur Gradium pour OpenClaw" icon="arrow-up-right-from-square" href="https://docs.openclaw.ai/providers/gradium">
    La référence OpenClaw du fournisseur Gradium TTS.
  </Card>

  <Card title="Intégration GitHub" icon="github" href="https://github.com/openclaw/openclaw/tree/6dbd5bd4460e5be753c2c0716829568a398a9562/extensions/gradium">
    Consultez le code source de l'extension Gradium pour OpenClaw.
  </Card>

  <Card title="Guide de synthèse vocale Gradium" icon="book" href="/fr/guides/text-to-speech">
    Configuration du TTS Gradium par WebSocket et comportement du streaming.
  </Card>
</CardGroup>

## Configuration

Créez une clé API Gradium, puis exposez-la à OpenClaw via une variable d'environnement :

```bash theme={null}
export GRADIUM_API_KEY=gd_your_api_key_here
```

OpenClaw peut aussi lire la clé depuis `messages.tts.providers.gradium.apiKey` dans `~/.openclaw/openclaw.json`.

## Configuration de base

Définissez `gradium` comme fournisseur TTS et choisissez un ID de voix Gradium.

```json theme={null}
{
  "messages": {
    "tts": {
      "auto": "always",
      "provider": "gradium",
      "providers": {
        "gradium": {
          "voiceId": "YTpq7expH9539ERJ",
          "apiKey": "${GRADIUM_API_KEY}"
        }
      }
    }
  }
}
```

Utilisez `auto: "always"` lorsque chaque réponse d'agent éligible doit inclure de l'audio. Utilisez les commandes de session d'OpenClaw ou la configuration par agent pour un comportement plus ciblé.

## Paramètres du fournisseur

| Paramètre | Description |
| - | - |
| `messages.tts.provider` | Définissez `gradium` pour faire de Gradium le fournisseur TTS principal. |
| `messages.tts.providers.gradium.apiKey` | Clé API Gradium. Vous pouvez utiliser `${GRADIUM_API_KEY}` ou vous appuyer sur la variable d'environnement. |
| `messages.tts.providers.gradium.voiceId` | ID de la voix Gradium utilisée par défaut pour les réponses. |
| `messages.tts.providers.gradium.baseUrl` | Remplacement facultatif de l'origine de l'API Gradium. `https://api.gradium.ai` par défaut. |

## Voix

Le fournisseur Gradium d'OpenClaw utilise Emma par défaut.

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

## Format de sortie

OpenClaw choisit le format de sortie Gradium selon la destination :

| Destination | Sortie Gradium |
| - | - |
| Réponse audio standard | Fichier audio WAV |
| Canal de messages vocaux | Audio Opus compatible avec les messages vocaux |
| Téléphonie | `ulaw_8000` à 8 kHz |

## Quand utiliser OpenClaw avec Gradium

* **Agents sur canaux de messagerie** : faites parler vos réponses sur les canaux pris en charge par OpenClaw sans développer de diffusion audio propre à chaque canal.
* **Workflows de messages vocaux** : envoyez des réponses parlées sous forme de médias vocaux compatibles avec le canal.
* **Téléphonie** : synthétisez de l'audio u-law 8 kHz pour les intégrations téléphoniques.
* **Stacks d'agents auto-hébergés** : conservez le modèle de passerelle locale d'OpenClaw tout en utilisant Gradium pour la sortie vocale.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.