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-key

Dadurch 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 volcengine
openclaw models list --provider volcengine-plan

Übergeben Sie den Schlüssel für die nicht interaktive Einrichtung (CI, Skripterstellung) 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. Die Einrichtung registriert beide automatisch, und die Modellauswahl des Coding-Providers verwendet außerdem die Authentifizierung des allgemeinen Providers (volcengine-plan ist ein Authentifizierungsalias von volcengine).

Integrierter Katalog

Allgemein (volcengine)
Coding (volcengine-plan)

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

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.

VOLCANO_ENGINE_API_KEY ist für die ModelArk-/Doubao-Modellendpunkte bestimmt 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 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).

Wenn OpenClaw als Hintergrunddienst ausgeführt wird, werden in Ihrer interaktiven Shell festgelegte Umgebungsvariablen nicht automatisch übernommen. Beachten Sie den obigen Hinweis zum Daemon.

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Konfiguration

Vollständige Konfigurationsreferenz für Agenten, Modelle und Provider.

Fehlerbehebung

Häufige Probleme und Schritte zur Fehlerdiagnose.

FAQ

Häufig gestellte Fragen zur Einrichtung von OpenClaw.

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

Erste Schritte

Provider und Endpunkte

Integrierter Katalog

Text-to-Speech

Erweiterte Konfiguration

Verwandte Themen

Modellauswahl

Konfiguration

Fehlerbehebung

FAQ

​Erste Schritte

​Provider und Endpunkte

​Integrierter Katalog

​Text-to-Speech

​Erweiterte Konfiguration

​Verwandte Themen

Modellauswahl

Konfiguration

Fehlerbehebung

FAQ

Erste Schritte

Provider und Endpunkte

Integrierter Katalog

Text-to-Speech

Erweiterte Konfiguration

Verwandte Themen