Passer au contenu principal

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.

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 séparés pour les charges de travail générales et de code. Le même Plugin intégré peut également enregistrer Volcengine Speech comme fournisseur de TTS.
DétailValeur
Fournisseursvolcengine (général + TTS) + volcengine-plan (code)
Authentification des modèlesVOLCANO_ENGINE_API_KEY
Authentification TTSVOLCENGINE_TTS_API_KEY ou BYTEPLUS_SEED_SPEECH_API_KEY
APIModèles compatibles OpenAI, TTS BytePlus Seed Speech

​
Premiers pas

1

Définir la clé API

Exécutez l’onboarding interactif :
openclaw onboard --auth-choice volcengine-api-key
Cela enregistre à la fois les fournisseurs général (volcengine) et de code (volcengine-plan) à partir d’une seule clé API.
2

Définir un modèle par défaut

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

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

FournisseurPoint de terminaisonCas d’usage
volcengineark.cn-beijing.volces.com/api/v3Modèles généraux
volcengine-planark.cn-beijing.volces.com/api/coding/v3Modèles de code
Les deux fournisseurs sont configurés à partir d’une seule clé API. La configuration les enregistre automatiquement tous les deux.

​
Catalogue intégré

Réf. de modèleNomEntréeContexte
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8texte, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028texte, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5texte, image256,000
volcengine/glm-4-7-251222GLM 4.7texte, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2texte, image128,000

​
Synthèse vocale

Le TTS Volcengine utilise l’API HTTP BytePlus Seed Speech et se configure séparément de la clé API du modèle Doubao compatible OpenAI. Dans la console BytePlus, ouvrez Seed Speech > Settings > API Keys et 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"
Ensuite, activez-le 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,
        },
      },
    },
  },
}
Pour les cibles de note vocale, OpenClaw demande à Volcengine le format natif du fournisseur ogg_opus. Pour les pièces jointes audio normales, il demande mp3. Les alias de fournisseur bytedance et doubao pointent également vers le même fournisseur vocal. L’identifiant de ressource par défaut est seed-tts-1.0 car c’est celui que BytePlus accorde aux clés API Seed Speech nouvellement créées dans le projet par défaut. Si votre projet dispose du droit 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 un ancien couple AppID/jeton de Speech Console.
L’authentification héritée AppID/jeton reste prise en charge pour les anciennes applications Speech Console : 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
Configuration avancée

openclaw onboard --auth-choice volcengine-api-key définit actuellement volcengine-plan/ark-code-latest comme modèle par défaut tout en enregistrant également le catalogue général volcengine.
Pendant l’onboarding/la configuration de la sélection du modèle, le choix d’authentification Volcengine privilégie à la fois les lignes 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 limité au fournisseur vide.
Si le Gateway s’exécute comme un daemon (launchd/systemd), assurez-vous que les variables d’environnement du modèle 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 disponibles pour ce processus (par exemple dans ~/.openclaw/.env ou via env.shellEnv).
Lorsque OpenClaw s’exécute comme service en arrière-plan, les variables d’environnement définies dans votre shell interactif ne sont pas automatiquement héritées. Voir la note ci-dessus sur le daemon.

​
Lié

Sélection du modèle

Choisir les fournisseurs, les références de modèles et le comportement de bascule.

Configuration

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

Dépannage

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

FAQ

Questions fréquentes sur la configuration d’OpenClaw.