मुख्य सामग्री पर जाएं
Volcengine प्रदाता Doubao मॉडलों और Volcano Engine पर होस्ट किए गए तृतीय-पक्ष मॉडलों तक पहुंच देता है, जिसमें सामान्य और कोडिंग वर्कलोड के लिए अलग-अलग एंडपॉइंट होते हैं। वही bundled plugin Volcengine Speech को TTS प्रदाता के रूप में भी रजिस्टर कर सकता है।
विवरणमान
प्रदाताvolcengine (सामान्य + TTS) + volcengine-plan (कोडिंग)
मॉडल authVOLCANO_ENGINE_API_KEY
TTS authVOLCENGINE_TTS_API_KEY या BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI-संगत मॉडल, BytePlus Seed Speech TTS

​
शुरू करना

1

API key सेट करें

इंटरैक्टिव ऑनबोर्डिंग चलाएं:
openclaw onboard --auth-choice volcengine-api-key
यह एक ही API key से सामान्य (volcengine) और कोडिंग (volcengine-plan) दोनों प्रदाताओं को रजिस्टर करता है।
2

डिफ़ॉल्ट मॉडल सेट करें

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

पुष्टि करें कि मॉडल उपलब्ध है

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
नॉन-इंटरैक्टिव सेटअप (CI, स्क्रिप्टिंग) के लिए, key सीधे पास करें:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
प्रदाता और एंडपॉइंट

प्रदाताएंडपॉइंटउपयोग का मामला
volcengineark.cn-beijing.volces.com/api/v3सामान्य मॉडल
volcengine-planark.cn-beijing.volces.com/api/coding/v3कोडिंग मॉडल
दोनों प्रदाता एक ही API key से कॉन्फ़िगर किए जाते हैं। सेटअप दोनों को अपने आप रजिस्टर करता है।

​
बिल्ट-इन कैटलॉग

मॉडल refनामइनपुटसंदर्भ
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8टेक्स्ट, इमेज256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028टेक्स्ट, इमेज256,000
volcengine/kimi-k2-5-260127Kimi K2.5टेक्स्ट, इमेज256,000
volcengine/glm-4-7-251222GLM 4.7टेक्स्ट, इमेज200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2टेक्स्ट, इमेज128,000

​
टेक्स्ट-टू-स्पीच

Volcengine TTS BytePlus Seed Speech HTTP API का उपयोग करता है और OpenAI-संगत Doubao मॉडल API key से अलग कॉन्फ़िगर किया जाता है। BytePlus console में, Seed Speech > Settings > API Keys खोलें और API key कॉपी करें, फिर सेट करें: 
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
फिर इसे 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,
        },
      },
    },
  },
}
वॉइस-नोट लक्ष्यों के लिए, OpenClaw Volcengine से प्रदाता-नेटिव ogg_opus मांगता है। सामान्य ऑडियो अटैचमेंट के लिए, यह mp3 मांगता है। प्रदाता aliases bytedance और doubao भी उसी speech प्रदाता पर resolve होते हैं। डिफ़ॉल्ट resource id seed-tts-1.0 है क्योंकि डिफ़ॉल्ट प्रोजेक्ट में नए बनाए गए Seed Speech API keys को BytePlus यही देता है। अगर आपके प्रोजेक्ट के पास TTS 2.0 entitlement है, तो VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 सेट करें।
VOLCANO_ENGINE_API_KEY ModelArk/Doubao मॉडल एंडपॉइंट के लिए है और Seed Speech API key नहीं है। TTS को BytePlus Speech Console से Seed Speech API key, या legacy Speech Console AppID/token जोड़ी चाहिए।
पुराने Speech Console applications के लिए legacy AppID/token auth समर्थित रहता है: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
उन्नत कॉन्फ़िगरेशन

openclaw onboard --auth-choice volcengine-api-key वर्तमान में volcengine-plan/ark-code-latest को डिफ़ॉल्ट मॉडल के रूप में सेट करता है, साथ ही सामान्य volcengine कैटलॉग भी रजिस्टर करता है।
ऑनबोर्डिंग/कॉन्फ़िगर मॉडल चयन के दौरान, Volcengine auth choice volcengine/* और volcengine-plan/* दोनों rows को प्राथमिकता देता है। अगर वे मॉडल अभी तक loaded नहीं हैं, तो OpenClaw खाली provider-scoped picker दिखाने के बजाय unfiltered catalog पर fallback करता है।
अगर Gateway daemon (launchd/systemd) के रूप में चलता है, तो सुनिश्चित करें कि मॉडल और TTS env vars जैसे VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID, और VOLCENGINE_TTS_TOKEN उस प्रक्रिया के लिए उपलब्ध हैं (उदाहरण के लिए, ~/.openclaw/.env में या env.shellEnv के माध्यम से)।
OpenClaw को background service के रूप में चलाते समय, आपके interactive shell में सेट environment variables अपने आप inherited नहीं होते। ऊपर daemon note देखें।

​
संबंधित

मॉडल चयन

प्रदाताओं, मॉडल refs, और failover behavior को चुनना।

कॉन्फ़िगरेशन

agents, मॉडल, और प्रदाताओं के लिए पूरा config reference।

समस्या निवारण

सामान्य समस्याएं और debugging steps।

FAQ

OpenClaw setup के बारे में अक्सर पूछे जाने वाले प्रश्न।