Providers
Volcengine (Doubao)
Der Volcengine-Provider bietet Zugriff auf Doubao-Modelle und Drittanbietermodelle, die auf Volcano Engine gehostet werden, mit separaten Endpunkten für allgemeine und Coding-Workloads. Dasselbe gebündelte Plugin registriert außerdem Volcengine Speech als TTS-Provider.
| Detail | Wert |
|---|---|
| Provider | volcengine (allgemein + TTS), volcengine-plan (Coding) |
| Modellauthentifizierung | VOLCANO_ENGINE_API_KEY |
| TTS-Authentifizierung | VOLCENGINE_TTS_API_KEY oder BYTEPLUS_SEED_SPEECH_API_KEY |
| API | OpenAI-kompatible Modelle, BytePlus Seed Speech TTS |
Erste Schritte
API-Schlüssel festlegen
Führen Sie das interaktive Onboarding aus:
openclaw onboard --auth-choice volcengine-api-keyDadurch werden sowohl der allgemeine (volcengine) als auch der Coding-Provider (volcengine-plan) mit einem einzigen API-Schlüssel registriert.
Standardmodell festlegen
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}Verfügbarkeit des Modells überprüfen
openclaw models list --provider volcengineopenclaw models list --provider volcengine-planProvider und Endpunkte
| Provider | Endpunkt | Anwendungsfall |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
Allgemeine Modelle |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
Coding-Modelle |
Integrierter Katalog
Allgemein (volcengine)
| Modellreferenz | Name | Eingabe | Kontext |
|---|---|---|---|
volcengine/deepseek-v3-2-251201 |
DeepSeek V3.2 | Text, Bild | 128,000 |
volcengine/doubao-seed-1-8-251228 |
Doubao Seed 1.8 | Text, Bild | 256,000 |
volcengine/doubao-seed-code-preview-251028 |
doubao-seed-code-preview-251028 | Text, Bild | 256,000 |
volcengine/glm-4-7-251222 |
GLM 4.7 | Text, Bild | 200,000 |
volcengine/kimi-k2-5-260127 |
Kimi K2.5 | Text, Bild | 256,000 |
Coding (volcengine-plan)
| Modellreferenz | Name | Eingabe | Kontext |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | Text | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | Text | 256,000 |
Beide Kataloge sind statisch (kein /models-Discovery-Aufruf) und unterstützen OpenAI-kompatible, gestreamte Nutzungsabrechnung. Die Tool-Schemas beider Provider entfernen automatisch die Schlüsselwörter minLength, maxLength, minItems, maxItems, minContains und maxContains, da die Tool-Call-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 separat vom API-Schlüssel für die OpenAI-kompatible 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 ihn anschließend in openclaw.json:
{ 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 tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey und baseUrl. !emotion=<value> funktioniert ebenfalls als Inline-Stimmanweisung, wenn Überschreibungen der Spracheinstellung zulässig sind.
Für Sprachnachrichtenziele fordert OpenClaw das Provider-native ogg_opus an. Für normale Audioanhänge fordert es mp3 an. Die Provider-Aliase bytedance und doubao werden ebenfalls diesem Sprach-Provider zugeordnet.
Die standardmäßige Ressourcen-ID ist seed-tts-1.0, die Berechtigung, die BytePlus neu erstellten Seed-Speech-API-Schlüsseln standardmäßig gewährt. 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 für ältere Speech-Console-Anwendungen weiterhin 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 gesetzt, die entsprechenden tts.providers.volcengine-Konfigurationsfelder.
Erweiterte Konfiguration
Standardmodell nach dem Onboarding
openclaw onboard --auth-choice volcengine-api-key legt volcengine-plan/ark-code-latest als Standardmodell fest und registriert gleichzeitig den allgemeinen volcengine-Katalog.
Fallback-Verhalten der Modellauswahl
Bei der Modellauswahl während des Onboardings oder der Konfiguration bevorzugt die Volcengine-Authentifizierungsoption sowohl volcengine/*- als auch volcengine-plan/*-Zeilen. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, statt eine leere, auf den Provider beschränkte Modellauswahl anzuzeigen.
Umgebungsvariablen für Daemon-Prozesse
Wenn das Gateway als Daemon (launchd/systemd) ausgeführt wird, stellen Sie sicher, dass Modell- und TTS-Umgebungsvariablen wie VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID und VOLCENGINE_TTS_TOKEN für diesen Prozess verfügbar sind (zum Beispiel in ~/.openclaw/.env oder über env.shellEnv).
