Volcengine (Doubao)

Le fournisseur Volcengine donne accès aux modèles Doubao et aux modèles tiers hébergés sur Volcano Engine, avec des points de terminaison distincts pour les charges de travail générales et de programmation. Le même plugin intégré enregistre également Volcengine Speech comme fournisseur TTS.

Détail	Valeur
Fournisseurs	`volcengine` (général + TTS), `volcengine-plan` (programmation)
Auth. modèles	`VOLCANO_ENGINE_API_KEY`
Auth. TTS	`VOLCENGINE_TTS_API_KEY` ou `BYTEPLUS_SEED_SPEECH_API_KEY`
API	Modèles compatibles avec OpenAI, TTS BytePlus Seed Speech

Bien démarrer

Définir la clé API

Exécutez la configuration initiale interactive :

openclaw onboard --auth-choice volcengine-api-key

Cette commande enregistre les fournisseurs général (volcengine) et de programmation (volcengine-plan) à partir d’une seule clé API.

Définir un modèle par défaut

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

Vérifier que le modèle est disponible

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan

Pour une configuration non interactive (CI, scripts), transmettez directement la clé :

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

Fournisseurs et points de terminaison

Fournisseur	Point de terminaison	Cas d’utilisation
`volcengine`	`ark.cn-beijing.volces.com/api/v3`	Modèles généraux
`volcengine-plan`	`ark.cn-beijing.volces.com/api/coding/v3`	Modèles de programmation

Les deux fournisseurs sont configurés à partir d’une seule clé API. La configuration les enregistre automatiquement, et le sélecteur de modèles du fournisseur de programmation réutilise également l’authentification du fournisseur général (volcengine-plan est un alias d’authentification de volcengine).

Catalogue intégré

Général (volcengine)
Programmation (volcengine-plan)

Référence du modèle	Nom	Entrée	Contexte
`volcengine/deepseek-v3-2-251201`	DeepSeek V3.2	texte, image	128,000
`volcengine/doubao-seed-1-8-251228`	Doubao Seed 1.8	texte, image	256,000
`volcengine/doubao-seed-code-preview-251028`	doubao-seed-code-preview-251028	texte, image	256,000
`volcengine/glm-4-7-251222`	GLM 4.7	texte, image	200,000
`volcengine/kimi-k2-5-260127`	Kimi K2.5	texte, image	256,000

Référence du modèle	Nom	Entrée	Contexte
`volcengine-plan/ark-code-latest`	Ark Coding Plan	texte	256,000
`volcengine-plan/doubao-seed-code`	Doubao Seed Code	texte	256,000
`volcengine-plan/doubao-seed-code-preview-251028`	Doubao Seed Code Preview	texte	256,000
`volcengine-plan/glm-4.7`	GLM 4.7 Coding	texte	200,000
`volcengine-plan/kimi-k2-thinking`	Kimi K2 Thinking	texte	256,000
`volcengine-plan/kimi-k2.5`	Kimi K2.5 Coding	texte	256,000

Les deux catalogues sont statiques (aucun appel de découverte à /models) et prennent en charge la comptabilisation de l’utilisation en flux continu compatible avec OpenAI. Les schémas d’outils des deux fournisseurs suppriment automatiquement les mots-clés minLength, maxLength, minItems, maxItems, minContains et maxContains, car l’API d’appel d’outils de Volcengine les rejette.

Synthèse vocale

Le TTS Volcengine utilise l’API HTTP BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) et se configure séparément de la clé API des modèles Doubao compatibles avec OpenAI. Dans la console BytePlus, ouvrez Seed Speech > Settings > API Keys, copiez la clé API, puis définissez :

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

Activez-le ensuite dans 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,
        },
      },
    },
  },
}

Champs disponibles sous messages.tts.providers.volcengine : apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey et baseUrl. !emotion=<value> fonctionne également comme directive vocale en ligne lorsque les remplacements des paramètres vocaux sont autorisés. Pour les destinations de type message vocal, OpenClaw demande le format natif du fournisseur ogg_opus. Pour les pièces jointes audio ordinaires, il demande mp3. Les alias de fournisseur bytedance et doubao correspondent également à ce fournisseur de synthèse vocale. L’identifiant de ressource par défaut est seed-tts-1.0, l’autorisation que BytePlus accorde par défaut aux nouvelles clés API Seed Speech. Si votre projet dispose de l’autorisation TTS 2.0, définissez VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.

VOLCANO_ENGINE_API_KEY est destiné aux points de terminaison des modèles ModelArk/Doubao et n’est pas une clé API Seed Speech. Le TTS nécessite une clé API Seed Speech provenant de la console BytePlus Speech, ou une ancienne paire AppID/jeton de la console Speech.

L’ancienne authentification par AppID/jeton reste prise en charge pour les applications plus anciennes de la console Speech :

export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

Autres variables d’environnement TTS facultatives : lorsqu’elles sont définies, VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY et VOLCENGINE_TTS_BASE_URL remplacent les champs de configuration correspondants de messages.tts.providers.volcengine.

Configuration avancée

Modèle par défaut après la configuration initiale

openclaw onboard --auth-choice volcengine-api-key définit volcengine-plan/ark-code-latest comme modèle par défaut tout en enregistrant également le catalogue général volcengine.

Comportement de repli du sélecteur de modèles

Pendant la sélection du modèle lors de la configuration initiale ou de la configuration, le choix d’authentification Volcengine privilégie les entrées volcengine/* et volcengine-plan/*. Si ces modèles ne sont pas encore chargés, OpenClaw se replie sur le catalogue non filtré au lieu d’afficher un sélecteur vide limité au fournisseur.

Variables d’environnement des processus démons

Si le Gateway s’exécute en tant que démon (launchd/systemd), assurez-vous que les variables d’environnement des modèles et du TTS, telles que VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID et VOLCENGINE_TTS_TOKEN, sont accessibles à ce processus (par exemple dans ~/.openclaw/.env ou via env.shellEnv).

Lorsque OpenClaw s’exécute en tant que service d’arrière-plan, les variables d’environnement définies dans votre shell interactif ne sont pas automatiquement héritées. Consultez la remarque ci-dessus concernant les démons.

Ressources associées

Sélection du modèle

Choix des fournisseurs, des références de modèles et du comportement de basculement.

Configuration

Référence complète de la configuration des agents, des modèles et des fournisseurs.

Dépannage

Problèmes courants et étapes de débogage.

FAQ

Questions fréquentes sur la configuration d’OpenClaw.

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

Bien démarrer

Fournisseurs et points de terminaison

Catalogue intégré

Synthèse vocale

Configuration avancée

Ressources associées

Sélection du modèle

Configuration

Dépannage

FAQ

​Bien démarrer

​Fournisseurs et points de terminaison

​Catalogue intégré

​Synthèse vocale

​Configuration avancée

​Ressources associées

Sélection du modèle

Configuration

Dépannage

FAQ

Bien démarrer

Fournisseurs et points de terminaison

Catalogue intégré

Synthèse vocale

Configuration avancée

Ressources associées