Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
DetailWert
Providervolcengine (allgemein + TTS) + volcengine-plan (Coding)
Modell-AuthVOLCANO_ENGINE_API_KEY
TTS-AuthVOLCENGINE_TTS_API_KEY oder BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI-kompatible Modelle, BytePlus Seed Speech TTS

​
Erste Schritte

1

Set the API key

Führen Sie das interaktive Onboarding aus:
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.
2

Set a default model

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

Verify the model is available

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

ProviderEndpunktAnwendungsfall
volcengineark.cn-beijing.volces.com/api/v3Allgemeine Modelle
volcengine-planark.cn-beijing.volces.com/api/coding/v3Coding-Modelle
Beide Provider werden mit einem einzigen API-Schlüssel konfiguriert. Das Setup registriert beide automatisch.

​
Integrierter Katalog

Modell-RefNameEingabeKontext
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8Text, Bild256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028Text, Bild256,000
volcengine/kimi-k2-5-260127Kimi K2.5Text, Bild256,000
volcengine/glm-4-7-251222GLM 4.7Text, Bild200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2Text, Bild128,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

Model selection

Auswahl von Providern, Modell-Refs und Failover-Verhalten.

Configuration

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

Troubleshooting

Häufige Probleme und Schritte zur Fehlerbehebung.

FAQ

Häufig gestellte Fragen zum OpenClaw-Setup.