Providers
ElevenLabs
OpenClaw usa ElevenLabs per la sintesi vocale, la trascrizione batch da voce a testo con Scribe v2 e l'STT in streaming con Scribe v2 Realtime.
| Capacità | Superficie OpenClaw | Predefinito |
|---|---|---|
| Sintesi vocale | messages.tts / talk |
eleven_multilingual_v2 |
| Trascrizione batch da voce a testo | tools.media.audio |
scribe_v2 |
| Trascrizione da voce a testo in streaming | Streaming Voice Call o Google Meet realtime.transcriptionProvider |
scribe_v2_realtime |
Autenticazione
Imposta ELEVENLABS_API_KEY nell'ambiente. XI_API_KEY è accettata anche per
compatibilità con gli strumenti ElevenLabs esistenti.
export ELEVENLABS_API_KEY="..."
Sintesi vocale
{
messages: {
tts: {
providers: {
elevenlabs: {
apiKey: "${ELEVENLABS_API_KEY}",
voiceId: "pMsXgVXv3BLzUgSXRplE",
modelId: "eleven_multilingual_v2",
},
},
},
},
}
Imposta modelId su eleven_v3 per usare ElevenLabs v3 TTS. OpenClaw mantiene
eleven_multilingual_v2 come predefinito per le installazioni esistenti.
I canali vocali Discord usano l'endpoint TTS in streaming di ElevenLabs quando ElevenLabs è
il provider voice.tts/messages.tts selezionato. La riproduzione parte dallo
stream audio restituito invece di attendere che OpenClaw scarichi e scriva prima
l'intero file audio. latencyTier viene mappato al parametro di query
optimize_streaming_latency di ElevenLabs per i modelli che lo accettano; OpenClaw
ometta quel parametro per eleven_v3, che lo rifiuta.
Da voce a testo
Usa Scribe v2 per gli allegati audio in ingresso e brevi segmenti vocali registrati:
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "elevenlabs", model: "scribe_v2" }],
},
},
},
}
OpenClaw invia audio multipart a ElevenLabs /v1/speech-to-text con
model_id: "scribe_v2". Gli suggerimenti sulla lingua vengono mappati a language_code quando presenti.
STT in streaming
Il Plugin elevenlabs incluso registra Scribe v2 Realtime per Voice Call e
per la trascrizione in streaming in modalità agente di Google Meet.
| Impostazione | Percorso di configurazione | Predefinito |
|---|---|---|
| Chiave API | plugins.entries.voice-call.config.streaming.providers.elevenlabs.apiKey |
Ripiega su ELEVENLABS_API_KEY / XI_API_KEY |
| Modello | ...elevenlabs.modelId |
scribe_v2_realtime |
| Formato audio | ...elevenlabs.audioFormat |
ulaw_8000 |
| Frequenza di campionamento | ...elevenlabs.sampleRate |
8000 |
| Strategia di commit | ...elevenlabs.commitStrategy |
vad |
| Lingua | ...elevenlabs.languageCode |
(non impostato) |
{
plugins: {
entries: {
"voice-call": {
config: {
streaming: {
enabled: true,
provider: "elevenlabs",
providers: {
elevenlabs: {
apiKey: "${ELEVENLABS_API_KEY}",
audioFormat: "ulaw_8000",
commitStrategy: "vad",
languageCode: "en",
},
},
},
},
},
},
},
}
Per la modalità agente di Google Meet, imposta
plugins.entries.google-meet.config.realtime.transcriptionProvider su
"elevenlabs" e configura lo stesso blocco provider sotto
plugins.entries.google-meet.config.realtime.providers.elevenlabs.