Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Il provider Volcengine offre accesso ai modelli Doubao e ai modelli di terze parti ospitati su Volcano Engine, con endpoint separati per i carichi di lavoro generali e di coding. Lo stesso Plugin incluso può anche registrare Volcengine Speech come provider TTS.
DettaglioValore
Providervolcengine (generale + TTS) + volcengine-plan (coding)
Autenticazione modelloVOLCANO_ENGINE_API_KEY
Autenticazione TTSVOLCENGINE_TTS_API_KEY o BYTEPLUS_SEED_SPEECH_API_KEY
APIModelli compatibili con OpenAI, TTS BytePlus Seed Speech

​
Per iniziare

1

Imposta la chiave API

Esegui l’onboarding interattivo:
openclaw onboard --auth-choice volcengine-api-key
Questo registra sia il provider generale (volcengine) sia quello di coding (volcengine-plan) a partire da una singola chiave API.
2

Imposta un modello predefinito

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

Verifica che il modello sia disponibile

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Per una configurazione non interattiva (CI, scripting), passa la chiave direttamente:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Provider ed endpoint

ProviderEndpointCaso d’uso
volcengineark.cn-beijing.volces.com/api/v3Modelli generali
volcengine-planark.cn-beijing.volces.com/api/coding/v3Modelli di coding
Entrambi i provider sono configurati da una singola chiave API. La configurazione li registra entrambi automaticamente.

​
Catalogo integrato

Model refNomeInputContesto
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8testo, immagine256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028testo, immagine256,000
volcengine/kimi-k2-5-260127Kimi K2.5testo, immagine256,000
volcengine/glm-4-7-251222GLM 4.7testo, immagine200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2testo, immagine128,000

​
Sintesi vocale

Il TTS di Volcengine usa l’API HTTP BytePlus Seed Speech ed è configurato separatamente dalla chiave API dei modelli Doubao compatibili con OpenAI. Nella console BytePlus, apri Seed Speech > Settings > API Keys e copia la chiave API, quindi imposta: 
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
Poi abilitalo in openclaw.json: 
{
  messages: {
    tts: {
      auto: "always",
      provider: "volcengine",
      providers: {
        volcengine: {
          apiKey: "byteplus_seed_speech_api_key",
          voice: "en_female_anna_mars_bigtts",
          speedRatio: 1.0,
        },
      },
    },
  },
}
Per le destinazioni con note vocali, OpenClaw richiede a Volcengine il formato nativo del provider ogg_opus. Per i normali allegati audio, richiede mp3. Anche gli alias del provider bytedance e doubao vengono risolti nello stesso provider vocale. L’ID risorsa predefinito è seed-tts-1.0 perché è quello che BytePlus assegna alle chiavi API Seed Speech appena create nel progetto predefinito. Se il tuo progetto ha l’abilitazione TTS 2.0, imposta VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY è per gli 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 Speech Console legacy.
L’autenticazione legacy AppID/token resta supportata per le applicazioni meno recenti della Speech Console: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
Configurazione avanzata

openclaw onboard --auth-choice volcengine-api-key attualmente imposta volcengine-plan/ark-code-latest come modello predefinito registrando anche il catalogo generale volcengine.
Durante l’onboarding/configurazione della selezione del modello, la scelta di autenticazione Volcengine privilegia sia le righe volcengine/* sia volcengine-plan/*. Se questi modelli non sono ancora caricati, OpenClaw ripiega sul catalogo non filtrato invece di mostrare un selettore limitato al provider vuoto.
Se il Gateway viene eseguito come daemon (launchd/systemd), assicurati che le variabili d’ambiente del modello 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 quel processo (per esempio, in ~/.openclaw/.env o tramite env.shellEnv).
Quando OpenClaw viene eseguito come servizio in background, le variabili d’ambiente impostate nella tua shell interattiva non vengono ereditate automaticamente. Vedi la nota precedente sui daemon.

​
Correlati

Selezione del modello

Scelta dei provider, dei model ref e del comportamento di failover.

Configurazione

Riferimento completo della configurazione per agenti, modelli e provider.

Risoluzione dei problemi

Problemi comuni e passaggi di debug.

FAQ

Domande frequenti sulla configurazione di OpenClaw.