Volcengine (Doubao)

Der Volcengine-Provider ermöglicht den Zugriff auf Doubao-Modelle und Drittanbietermodelle, die auf Volcano Engine gehostet werden. Dabei werden separate Endpunkte für allgemeine Aufgaben und Coding-Workloads verwendet. Dasselbe gebündelte Plugin registriert außerdem Volcengine Speech als TTS-Provider.

Erste Schritte

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

Provider und Endpunkte

Integrierter Katalog

Beide Kataloge sind statisch (kein /models-Erkennungsaufruf) und unterstützen eine OpenAI-kompatible Nutzungsabrechnung bei gestreamter Verwendung. Die Tool-Schemas beider Provider entfernen automatisch die Schlüsselwörter minLength, maxLength, minItems, maxItems, minContains und maxContains, da die Tool-Aufruf-API von Volcengine diese ablehnt.

Text-to-Speech

Volcengine TTS verwendet die BytePlus Seed Speech HTTP-API (voice.ap-southeast-1.bytepluses.com) und wird unabhängig vom API-Schlüssel der OpenAI-kompatiblen Doubao-Modell-API konfiguriert. Öffnen Sie in der BytePlus-Konsole Seed Speech > Settings > API Keys, kopieren Sie den API-Schlüssel und legen Sie anschließend Folgendes fest:

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

Aktivieren Sie den Provider anschließend 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,        },      },    },  },}

Verfügbare Felder unter messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey und baseUrl. !emotion=<value> kann ebenfalls als Inline-Stimmanweisung verwendet werden, wenn Überschreibungen der Stimmeinstellungen zulässig sind.

Für Ziele mit Sprachnachrichten fordert OpenClaw das native Providerformat ogg_opus an. Für normale Audioanhänge wird mp3 angefordert. Die Provider-Aliase bytedance und doubao werden ebenfalls diesem Sprach-Provider zugeordnet.

Die standardmäßige Ressourcen-ID ist seed-tts-1.0. Diese Berechtigung gewährt BytePlus neu erstellten Seed-Speech-API-Schlüsseln standardmäßig. Wenn Ihr Projekt über eine TTS-2.0-Berechtigung verfügt, legen Sie VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 fest.

Die ältere AppID-/Token-Authentifizierung wird weiterhin für ältere Speech-Console-Anwendungen unterstützt:

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

Weitere optionale TTS-Umgebungsvariablen: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY und VOLCENGINE_TTS_BASE_URL überschreiben, sofern festgelegt, die entsprechenden Konfigurationsfelder unter messages.tts.providers.volcengine.

Erweiterte Konfiguration

Verwandte Themen