Skip to main content
De Volcengine-provider biedt toegang tot Doubao-modellen en modellen van derden die op Volcano Engine worden gehost, met afzonderlijke eindpunten voor algemene en programmeerworkloads. Dezelfde gebundelde Plugin registreert ook Volcengine Speech als TTS-provider.

​
Aan de slag

1

Stel de API-sleutel in

Voer de interactieve onboarding uit:
Hiermee worden zowel de algemene provider (volcengine) als de programmeerprovider (volcengine-plan) met één API-sleutel geregistreerd.
2

Stel een standaardmodel in

3

Controleer of het model beschikbaar is

Geef voor niet-interactieve configuratie (CI, scripts) de sleutel rechtstreeks door:

​
Providers en eindpunten

Beide providers worden met één API-sleutel geconfigureerd. Tijdens de configuratie worden beide automatisch geregistreerd en de modelkiezer van de programmeerprovider hergebruikt ook de authenticatie van de algemene provider (volcengine-plan is een authenticatiealias van volcengine).

​
Ingebouwde catalogus

Beide catalogi zijn statisch (geen /models-detectieaanroep) en ondersteunen OpenAI-compatibele gebruiksregistratie bij streaming. Toolschema’s voor beide providers verwijderen automatisch de sleutelwoorden minLength, maxLength, minItems, maxItems, minContains en maxContains, omdat de tool-call-API van Volcengine deze afwijst.

​
Tekst-naar-spraak

Volcengine TTS gebruikt de BytePlus Seed Speech HTTP-API (voice.ap-southeast-1.bytepluses.com) en wordt afzonderlijk geconfigureerd van de API-sleutel voor de OpenAI-compatibele Doubao-model-API. Open in de BytePlus-console Seed Speech > Settings > API Keys, kopieer de API-sleutel en stel vervolgens het volgende in:
Schakel deze vervolgens in via openclaw.json:
Beschikbare velden onder tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey en baseUrl. !emotion=<value> werkt ook als inline steminstructie wanneer overschrijvingen van de steminstelling zijn toegestaan. Voor doelen voor spraakberichten vraagt OpenClaw de providerspecifieke ogg_opus aan. Voor normale audiobijlagen vraagt het mp3 aan. De provideraliassen bytedance en doubao verwijzen ook naar deze spraakprovider. De standaardresource-id is seed-tts-1.0, de gebruiksmachtiging die BytePlus standaard aan nieuw aangemaakte Seed Speech-API-sleutels verleent. Als je project een TTS 2.0-gebruiksmachtiging heeft, stel je VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 in.
VOLCANO_ENGINE_API_KEY is bedoeld voor de ModelArk-/Doubao-modeleindpunten en is geen Seed Speech-API-sleutel. Voor TTS is een Seed Speech-API-sleutel uit de BytePlus Speech Console vereist, of een verouderd AppID/token-paar uit de Speech Console.
Verouderde AppID/token-authenticatie blijft ondersteund voor oudere Speech Console-applicaties:
Andere optionele TTS-omgevingsvariabelen: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY en VOLCENGINE_TTS_BASE_URL overschrijven de overeenkomstige tts.providers.volcengine-configuratievelden wanneer ze zijn ingesteld.

​
Geavanceerde configuratie

openclaw onboard --auth-choice volcengine-api-key stelt volcengine-plan/ark-code-latest in als standaardmodel en registreert tegelijk de algemene volcengine-catalogus.
Tijdens de modelselectie bij onboarding/configuratie geeft de Volcengine-authenticatiekeuze de voorkeur aan zowel de rijen volcengine/* als volcengine-plan/*. Als die modellen nog niet zijn geladen, valt OpenClaw terug op de ongefilterde catalogus in plaats van een lege providergebonden modelkiezer weer te geven.
Als de Gateway als daemon wordt uitgevoerd (launchd/systemd), zorg er dan voor dat omgevingsvariabelen voor modellen en TTS, zoals VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID en VOLCENGINE_TTS_TOKEN, beschikbaar zijn voor dat proces (bijvoorbeeld in ~/.openclaw/.env of via env.shellEnv).
Wanneer OpenClaw als achtergrondservice wordt uitgevoerd, worden omgevingsvariabelen die in je interactieve shell zijn ingesteld niet automatisch overgenomen. Zie de opmerking over de daemon hierboven.

​
Gerelateerd

Modelselectie

Providers, modelreferenties en failovergedrag kiezen.

Configuratie

Volledige configuratiereferentie voor agents, modellen en providers.

Problemen oplossen

Veelvoorkomende problemen en stappen voor foutopsporing.

Veelgestelde vragen

Veelgestelde vragen over het configureren van OpenClaw.