Skip to main content
Il provider Volcengine consente di accedere ai modelli Doubao e ai modelli di terze parti ospitati su Volcano Engine, con endpoint distinti per i carichi di lavoro generici e di programmazione. Lo stesso plugin incluso registra anche Volcengine Speech come provider TTS.

​
Per iniziare

1

Set the API key

Esegui la configurazione iniziale interattiva:
Questo registra sia il provider generico (volcengine) sia quello di programmazione (volcengine-plan) usando un’unica chiave API.
2

Set a default model

3

Verify the model is available

Per la configurazione non interattiva (CI, scripting), passa direttamente la chiave:

​
Provider ed endpoint

Entrambi i provider vengono configurati con un’unica chiave API. La configurazione li registra entrambi automaticamente e il selettore dei modelli del provider di programmazione riutilizza anche l’autenticazione del provider generico (volcengine-plan è un alias di autenticazione di volcengine).

​
Catalogo integrato

Entrambi i cataloghi sono statici (non viene effettuata alcuna chiamata di individuazione a /models) e supportano la contabilizzazione in streaming dell’utilizzo compatibile con OpenAI. Gli schemi degli strumenti per entrambi i provider eliminano automaticamente le parole chiave minLength, maxLength, minItems, maxItems, minContains e maxContains, poiché l’API per le chiamate agli strumenti di Volcengine le rifiuta.

​
Sintesi vocale

Il TTS di Volcengine utilizza l’API HTTP BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) e viene configurato separatamente dalla chiave API dei modelli Doubao compatibile con OpenAI. Nella console BytePlus, apri Seed Speech > Settings > API Keys, copia la chiave API, quindi imposta:
Quindi abilitalo in openclaw.json:
Campi disponibili in messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey e baseUrl. Anche !emotion=<value> funziona come direttiva vocale incorporata quando sono consentite le sostituzioni delle impostazioni vocali. Per le destinazioni di messaggi vocali, OpenClaw richiede il formato nativo del provider ogg_opus. Per i normali allegati audio, richiede mp3. Anche gli alias del provider bytedance e doubao vengono risolti in questo provider vocale. L’ID risorsa predefinito è seed-tts-1.0, l’abilitazione che BytePlus concede per impostazione predefinita alle chiavi API Seed Speech appena create. Se il tuo progetto dispone dell’abilitazione TTS 2.0, imposta VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY è destinata agli endpoint dei modelli ModelArk/Doubao e non è una chiave API Seed Speech. Il TTS richiede una chiave API Seed Speech dalla BytePlus Speech Console oppure una coppia AppID/token della precedente Speech Console.
L’autenticazione precedente tramite AppID/token rimane supportata per le applicazioni Speech Console meno recenti:
Altre variabili di ambiente TTS facoltative: quando impostate, VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY e VOLCENGINE_TTS_BASE_URL sostituiscono i campi di configurazione corrispondenti in messages.tts.providers.volcengine.

​
Configurazione avanzata

openclaw onboard --auth-choice volcengine-api-key imposta volcengine-plan/ark-code-latest come modello predefinito, registrando al contempo il catalogo generico volcengine.
Durante la selezione del modello nella configurazione iniziale o nella configurazione successiva, la scelta di autenticazione Volcengine privilegia sia le righe volcengine/* sia quelle volcengine-plan/*. Se questi modelli non sono ancora caricati, OpenClaw utilizza come alternativa il catalogo non filtrato anziché mostrare un selettore vuoto limitato al provider.
Se il Gateway viene eseguito come daemon (launchd/systemd), assicurati che le variabili di ambiente dei modelli e del TTS, come VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID e VOLCENGINE_TTS_TOKEN, siano disponibili per tale processo, ad esempio in ~/.openclaw/.env o tramite env.shellEnv.
Quando OpenClaw viene eseguito come servizio in background, le variabili di ambiente impostate nella shell interattiva non vengono ereditate automaticamente. Consulta la nota sui daemon riportata sopra.

​
Contenuti correlati

Model selection

Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.

Configuration

Riferimento completo della configurazione per agenti, modelli e provider.

Troubleshooting

Problemi comuni e procedure di debug.

FAQ

Domande frequenti sulla configurazione di OpenClaw.