---
read_when:
- Sie möchten Modelle von Volcano Engine oder Doubao mit OpenClaw verwenden
- Sie müssen den Volcengine-API-Schlüssel einrichten
- Sie möchten Volcengine Speech für die Sprachsynthese verwenden
summary: Einrichtung von Volcano Engine (Doubao-Modelle, Coding-Endpunkte und Seed Speech TTS)
title: Volcengine (Doubao)
x-i18n:
generated_at: "2026-07-12T02:06:55Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: e853a1c8847704caedf0ec83c38332569f72105c5e34ad973daf614a2e80550b
source_path: providers/volcengine.md
workflow: 16
---
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.
| 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
Führen Sie das interaktive Onboarding aus:
```bash
openclaw onboard --auth-choice volcengine-api-key
```
Dadurch werden sowohl der allgemeine Provider (`volcengine`) als auch der Coding-Provider (`volcengine-plan`) mit einem einzigen API-Schlüssel registriert.
```json5
{
agents: {
defaults: {
model: { primary: "volcengine-plan/ark-code-latest" },
},
},
}
```
```bash
openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
```
Für eine nicht interaktive Einrichtung (CI, Skripterstellung) übergeben Sie den Schlüssel direkt:
```bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice volcengine-api-key \
--volcengine-api-key "$VOLCANO_ENGINE_API_KEY"
```
## Provider 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 |
Beide Provider werden mit einem einzigen API-Schlüssel konfiguriert. Bei der Einrichtung werden beide automatisch registriert. Die Modellauswahl des Coding-Providers verwendet außerdem die Authentifizierung des allgemeinen Providers erneut (`volcengine-plan` ist ein Authentifizierungsalias von `volcengine`).
## Integrierter Katalog
| 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 |
| 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 |
| `volcengine-plan/doubao-seed-code-preview-251028` | Doubao Seed Code Preview | Text | 256,000 |
| `volcengine-plan/glm-4.7` | GLM 4.7 Coding | Text | 200,000 |
| `volcengine-plan/kimi-k2-thinking` | Kimi K2 Thinking | Text | 256,000 |
| `volcengine-plan/kimi-k2.5` | Kimi K2.5 Coding | Text | 256,000 |
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:
```bash
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`:
```json5
{
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=` 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.
`VOLCANO_ENGINE_API_KEY` ist für die ModelArk-/Doubao-Modellendpunkte vorgesehen und kein Seed-Speech-API-Schlüssel. TTS benötigt einen Seed-Speech-API-Schlüssel aus der BytePlus Speech Console oder ein älteres AppID-/Token-Paar aus der Speech Console.
Die ältere AppID-/Token-Authentifizierung wird weiterhin für ältere Speech-Console-Anwendungen unterstützt:
```bash
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
`openclaw onboard --auth-choice volcengine-api-key` legt `volcengine-plan/ark-code-latest` als Standardmodell fest und registriert zugleich den allgemeinen `volcengine`-Katalog.
Bei der Modellauswahl während des Onboardings oder der Konfiguration bevorzugt die Volcengine-Authentifizierungsoption sowohl Einträge vom Typ `volcengine/*` als auch vom Typ `volcengine-plan/*`. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, anstatt eine leere, auf den Provider beschränkte Auswahl anzuzeigen.
Wenn der Gateway als Daemon ausgeführt wird (launchd/systemd), 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, beispielsweise in `~/.openclaw/.env` oder über `env.shellEnv`.
Wenn OpenClaw als Hintergrunddienst ausgeführt wird, werden die in Ihrer interaktiven Shell festgelegten Umgebungsvariablen nicht automatisch übernommen. Beachten Sie den obigen Hinweis zum Daemon.
## Verwandte Themen
Auswahl von Providern und Modellreferenzen sowie Konfiguration des Failover-Verhaltens.
Vollständige Konfigurationsreferenz für Agenten, Modelle und Provider.
Häufige Probleme und Schritte zur Fehlerdiagnose.
Häufig gestellte Fragen zur Einrichtung von OpenClaw.