---
read_when:
    - Ti serve Gradium per la sintesi vocale
    - È necessaria la configurazione della chiave API Gradium, della voce o del token di direttiva
summary: Usare la sintesi vocale Gradium in OpenClaw
title: Gradium
x-i18n:
    generated_at: "2026-05-10T19:49:19Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5c79da6ec63532061a8112965a679f1113bbefcc91ee00def8153dd39b5b5e58
    source_path: providers/gradium.md
    workflow: 16
---

[Gradium](https://gradium.ai) è un provider di sintesi vocale incluso in OpenClaw. Il plugin può generare normali risposte audio (WAV), output Opus compatibile con note vocali e audio u-law a 8 kHz per superfici di telefonia.

| Proprietà      | Valore                               |
| -------------- | ------------------------------------ |
| ID provider    | `gradium`                            |
| Autenticazione | `GRADIUM_API_KEY` o config `apiKey`  |
| URL di base    | `https://api.gradium.ai` (default)   |
| Voce predefinita | `Emma` (`YTpq7expH9539ERJ`)        |

## Configurazione

Crea una chiave API Gradium, quindi esponila a OpenClaw con una variabile d'ambiente o con la chiave di configurazione.

<Tabs>
  <Tab title="Variabile d'ambiente">
    ```bash
    export GRADIUM_API_KEY="gsk_..."
    ```
  </Tab>

  <Tab title="Chiave di configurazione">
    ```json5
    {
      messages: {
        tts: {
          auto: "always",
          provider: "gradium",
          providers: {
            gradium: {
              apiKey: "${GRADIUM_API_KEY}",
            },
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>

Il plugin controlla prima l'`apiKey` risolta e, in alternativa, usa la variabile d'ambiente `GRADIUM_API_KEY`.

## Configurazione

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

| Chiave                                   | Tipo   | Descrizione                                                                                   |
| ---------------------------------------- | ------ | --------------------------------------------------------------------------------------------- |
| `messages.tts.providers.gradium.apiKey`  | string | Chiave API risolta. Supporta `${ENV}` e riferimenti a segreti.                                |
| `messages.tts.providers.gradium.baseUrl` | string | Sovrascrive l'origine API. Le barre finali vengono rimosse. Il valore predefinito è `https://api.gradium.ai`. |
| `messages.tts.providers.gradium.voiceId` | string | ID della voce predefinita usato quando non è presente alcuna sovrascrittura tramite direttiva. |

Il formato audio di output viene selezionato automaticamente dal runtime in base alla superficie di destinazione e non è configurabile da `openclaw.json`. Vedi [Output](#output) sotto.

## Voci

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

Voce predefinita: Emma.

### Sovrascrittura della voce per messaggio

Quando la policy vocale attiva consente le sovrascritture della voce, puoi cambiare voce inline usando un token direttiva. Tutti questi vengono risolti nella stessa sovrascrittura di `voiceId`:

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

Se la policy vocale disabilita le sovrascritture della voce, la direttiva viene consumata ma ignorata.

## Output

Il runtime sceglie il formato di output dalla superficie di destinazione. Oggi il provider non sintetizza altri formati.

| Destinazione   | Formato     | Estensione file | Frequenza di campionamento | Flag compatibile con voce |
| -------------- | ----------- | --------------- | --------------------------- | ------------------------- |
| Audio standard | `wav`       | `.wav`          | provider                    | no                        |
| Nota vocale    | `opus`      | `.opus`         | provider                    | sì                        |
| Telefonia      | `ulaw_8000` | n/d             | 8 kHz                       | n/d                       |

## Ordine di selezione automatica

Tra i provider TTS configurati, l'ordine di selezione automatica di Gradium è `30`. Vedi [Sintesi vocale](/it/tools/tts) per sapere come OpenClaw sceglie il provider attivo quando `messages.tts.provider` non è fissato.

## Correlati

- [Sintesi vocale](/it/tools/tts)
- [Panoramica dei media](/it/tools/media-overview)