docs/docs/de/providers/volcengine.md

read_when	summary	title	x-i18n
Sie möchten Volcano Engine oder Doubao-Modelle mit OpenClaw verwenden Sie benötigen die Einrichtung des Volcengine-API-Schlüssels Sie möchten Volcengine Speech für Text-to-Speech verwenden	Einrichtung von Volcano Engine (Doubao-Modelle, Coding-Endpunkte und Seed Speech TTS)	Volcengine (Doubao)	generated_at model provider source_hash source_path workflow 2026-04-26T11:38:20Z gpt-5.4 openai b7948a26cc898e125d445e9ae091704f5cf442266d29e712c0dcedbe0dc0cce7 providers/volcengine.md 15

Der Volcengine-Provider bietet Zugriff auf Doubao-Modelle und Drittanbieter-Modelle, die auf Volcano Engine gehostet werden, mit separaten Endpunkten für allgemeine und Coding- Workloads. Dasselbe gebündelte Plugin kann auch Volcengine Speech als TTS- Provider registrieren.

Detail	Wert
Provider	volcengine (allgemein + TTS) + volcengine-plan (Coding)
Modell-Auth	VOLCANO_ENGINE_API_KEY
TTS-Auth	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 nicht interaktives Setup (CI, Skripting) übergeben Sie den Schlüssel direkt:

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. Das Setup registriert beide automatisch.

Integrierter Katalog

| Modell-Ref | Name | Eingabe | Kontext | | -------------------------------------------- | ------------------------------- | ---------- | ------- | | `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/kimi-k2-5-260127` | Kimi K2.5 | Text, Bild | 256,000 | | `volcengine/glm-4-7-251222` | GLM 4.7 | Text, Bild | 200,000 | | `volcengine/deepseek-v3-2-251201` | DeepSeek V3.2 | Text, Bild | 128,000 | | Modell-Ref | 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/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 | | `volcengine-plan/doubao-seed-code-preview-251028` | Doubao Seed Code Preview | Text | 256,000 |

Text-to-Speech

Volcengine TTS verwendet die BytePlus Seed Speech HTTP API und wird getrennt vom OpenAI-kompatiblen Doubao-Modell-API-Schlüssel konfiguriert. Öffnen Sie in der BytePlus- Konsole Seed Speech > Settings > API Keys und kopieren Sie den API-Schlüssel. Setzen Sie dann:

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

Aktivieren Sie es dann 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,
        },
      },
    },
  },
}

Für Voice-Note-Ziele fordert OpenClaw von Volcengine das providernative ogg_opus an. Für normale Audioanhänge fordert es mp3 an. Die Provider-Aliase bytedance und doubao werden ebenfalls auf denselben Speech-Provider aufgelöst.

Die Standard-Resource-ID ist seed-tts-1.0, weil BytePlus diese neu erstellten Seed-Speech-API-Schlüsseln im Standardprojekt zuweist. Wenn Ihr Projekt eine TTS-2.0-Berechtigung hat, setzen Sie VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.

`VOLCANO_ENGINE_API_KEY` ist für die Modellendpunkte von ModelArk/Doubao und kein Seed-Speech-API-Schlüssel. TTS benötigt einen Seed-Speech-API-Schlüssel aus der BytePlus Speech Console oder ein altes AppID-/Token-Paar aus der Speech Console.

Alte AppID-/Token-Authentifizierung bleibt 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"

Erweiterte Konfiguration

`openclaw onboard --auth-choice volcengine-api-key` setzt derzeit `volcengine-plan/ark-code-latest` als Standardmodell und registriert gleichzeitig den allgemeinen Katalog `volcengine`. Während der Modellauswahl beim Onboarding/Konfigurieren bevorzugt die Volcengine-Auth-Auswahl sowohl Zeilen `volcengine/*` als auch `volcengine-plan/*`. Wenn diese Modelle noch nicht geladen sind, greift OpenClaw auf den ungefilterten Katalog zurück, anstatt einen leeren providerbezogenen Picker anzuzeigen. Wenn das Gateway als Daemon läuft (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` diesem Prozess zur Verfügung stehen (zum Beispiel in `~/.openclaw/.env` oder über `env.shellEnv`). Wenn OpenClaw als Hintergrunddienst läuft, werden Umgebungsvariablen aus Ihrer interaktiven Shell nicht automatisch übernommen. Siehe den Daemon-Hinweis oben.

Verwandt

Auswahl von Providern, Modell-Refs und Failover-Verhalten. Vollständige Konfigurationsreferenz für Agenten, Modelle und Provider. Häufige Probleme und Schritte zur Fehlerbehebung. Häufig gestellte Fragen zum OpenClaw-Setup.