Volcengine (Doubao)

De Volcengine-provider biedt toegang tot Doubao-modellen en modellen van derden die op Volcano Engine worden gehost, met afzonderlijke endpoints voor algemene en programmeerwerklasten. Dezelfde gebundelde plugin registreert ook Volcengine Speech als TTS-provider.

Aan de slag

openclaw onboard --auth-choice volcengine-api-key

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

openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan

Providers en endpoints

Ingebouwde catalogus

Beide catalogi zijn statisch (geen /models-detectieaanroep) en ondersteunen OpenAI-compatibele, gestreamde gebruiksregistratie. Toolschema's voor beide providers verwijderen automatisch de sleutelwoorden minLength, maxLength, minItems, maxItems, minContains en maxContains, omdat de toolaanroep-API van Volcengine deze weigert.

Tekst-naar-spraak

Volcengine TTS gebruikt de HTTP-API van BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) en wordt afzonderlijk van de API-sleutel voor de OpenAI-compatibele Doubao-model-API geconfigureerd. Open in de BytePlus-console Seed Speech > Settings > API Keys, kopieer de API-sleutel en stel vervolgens het volgende in:

export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"

Schakel deze vervolgens in openclaw.json in:

{  messages: {    tts: {      auto: "always",      provider: "volcengine",      providers: {        volcengine: {          apiKey: "byteplus_seed_speech_api_key",          voice: "en_female_anna_mars_bigtts",          speedRatio: 1.0,        },      },    },  },}

Beschikbare velden onder messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey en baseUrl. !emotion=<value> werkt ook als een inline steminstructie wanneer overschrijvingen van steminstellingen zijn toegestaan.

Voor doelen voor spraakberichten vraagt OpenClaw om de provider-eigen indeling ogg_opus. Voor normale audiobijlagen vraagt het om mp3. De provideraliassen bytedance en doubao verwijzen ook naar deze spraakprovider.

De standaardresource-id is seed-tts-1.0, de machtiging die BytePlus standaard aan nieuw aangemaakte Seed Speech-API-sleutels verleent. Als uw project een TTS 2.0-machtiging heeft, stelt u VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 in.

Verouderde AppID/token-authenticatie blijft ondersteund voor oudere Speech Console-toepassingen:

export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"

Andere optionele TTS-omgevingsvariabelen: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY en VOLCENGINE_TTS_BASE_URL overschrijven, wanneer ze zijn ingesteld, de overeenkomstige configuratievelden van messages.tts.providers.volcengine.

Geavanceerde configuratie

Gerelateerd