Zum Hauptinhalt springen

Volcengine (Doubao)

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.
DetailWert
Providervolcengine (allgemein) + volcengine-plan (Coding)
AuthVOLCANO_ENGINE_API_KEY
APIOpenAI-kompatibel

Erste Schritte

1

API-Schlüssel festlegen

Führen Sie das interaktive Onboarding aus:
openclaw onboard --auth-choice volcengine-api-key
Dadurch werden sowohl die allgemeinen (volcengine) als auch die Coding-Provider (volcengine-plan) mit einem einzigen API-Schlüssel registriert.
2

Ein Standardmodell festlegen

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

Prüfen, ob das Modell verfügbar ist

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.

Verfügbare Modelle

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

Erweiterte Hinweise

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 Onboarding-/Konfigurationsauswahl des Modells bevorzugt die Volcengine-Auth-Auswahl sowohl Zeilen volcengine/* als auch volcengine-plan/*. Wenn diese Modelle noch nicht geladen sind, fällt OpenClaw auf den ungefilterten Katalog zurück, statt eine leere providerbezogene Auswahl anzuzeigen.
Wenn das Gateway als Daemon läuft (launchd/systemd), stellen Sie sicher, dass VOLCANO_ENGINE_API_KEY für diesen Prozess verfügbar ist (zum Beispiel in ~/.openclaw/.env oder über env.shellEnv).
Wenn OpenClaw als Hintergrunddienst läuft, werden in Ihrer interaktiven Shell gesetzte Umgebungsvariablen nicht automatisch übernommen. Siehe den obigen Hinweis zu Daemons.

Verwandte Themen

Modellauswahl

Provider, Modell-Refs und Failover-Verhalten auswählen.

Konfiguration

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

Fehlerbehebung

Häufige Probleme und Debugging-Schritte.

FAQ

Häufig gestellte Fragen zum OpenClaw-Setup.