Volcengine (Doubao)

Volcengine प्रदाता Doubao मॉडल और Volcano Engine पर होस्ट किए गए तृतीय-पक्ष मॉडल तक पहुँच प्रदान करता है, जिसमें सामान्य और कोडिंग कार्यभार के लिए अलग-अलग एंडपॉइंट हैं। यही बंडल किया गया plugin Volcengine Speech को TTS प्रदाता के रूप में भी पंजीकृत करता है।

विवरण	मान
प्रदाता	`volcengine` (सामान्य + TTS), `volcengine-plan` (कोडिंग)
मॉडल प्रमाणीकरण	`VOLCANO_ENGINE_API_KEY`
TTS प्रमाणीकरण	`VOLCENGINE_TTS_API_KEY` या `BYTEPLUS_SEED_SPEECH_API_KEY`
API	OpenAI-संगत मॉडल, BytePlus Seed Speech TTS

आरंभ करना

API कुंजी सेट करें

इंटरैक्टिव ऑनबोर्डिंग चलाएँ:

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

यह एक ही API कुंजी से सामान्य (volcengine) और कोडिंग (volcengine-plan) दोनों प्रदाताओं को पंजीकृत करता है।

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

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

सत्यापित करें कि मॉडल उपलब्ध है

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

गैर-इंटरैक्टिव सेटअप (CI, स्क्रिप्टिंग) के लिए, कुंजी सीधे पास करें:

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

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

प्रदाता	एंडपॉइंट	उपयोग का मामला
`volcengine`	`ark.cn-beijing.volces.com/api/v3`	सामान्य मॉडल
`volcengine-plan`	`ark.cn-beijing.volces.com/api/coding/v3`	कोडिंग मॉडल

दोनों प्रदाता एक ही API कुंजी से कॉन्फ़िगर किए जाते हैं। सेटअप दोनों को अपने-आप पंजीकृत करता है, और कोडिंग प्रदाता का मॉडल चयनकर्ता सामान्य प्रदाता के प्रमाणीकरण का भी पुनः उपयोग करता है (volcengine-plan, volcengine का प्रमाणीकरण उपनाम है)।

अंतर्निहित कैटलॉग

सामान्य (volcengine)
कोडिंग (volcengine-plan)

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

मॉडल संदर्भ	नाम	इनपुट	संदर्भ
`volcengine-plan/ark-code-latest`	Ark Coding Plan	टेक्स्ट	256,000
`volcengine-plan/doubao-seed-code`	Doubao Seed Code	टेक्स्ट	256,000

दोनों कैटलॉग स्थिर हैं (कोई /models खोज कॉल नहीं) और OpenAI-संगत स्ट्रीम किए गए उपयोग लेखांकन का समर्थन करते हैं। दोनों प्रदाताओं की टूल स्कीमा से minLength, maxLength, minItems, maxItems, minContains, और maxContains कीवर्ड अपने-आप हटा दिए जाते हैं, क्योंकि Volcengine टूल-कॉल API उन्हें अस्वीकार करता है।

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

Volcengine TTS, BytePlus Seed Speech HTTP API (voice.ap-southeast-1.bytepluses.com) का उपयोग करता है और इसे OpenAI-संगत Doubao मॉडल API कुंजी से अलग कॉन्फ़िगर किया जाता है। BytePlus कंसोल में Seed Speech > Settings > API Keys खोलें, API कुंजी कॉपी करें, फिर सेट करें:

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

फिर इसे openclaw.json में सक्षम करें:

{
  tts: {
    auto: "always",
    provider: "volcengine",
    providers: {
      volcengine: {
        apiKey: "byteplus_seed_speech_api_key",
        voice: "en_female_anna_mars_bigtts",
        speedRatio: 1.0,
      },
    },
  },
}

tts.providers.volcengine के अंतर्गत उपलब्ध फ़ील्ड: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey, और baseUrl। वॉइस-सेटिंग ओवरराइड की अनुमति होने पर !emotion=<value> इनलाइन वॉइस निर्देश के रूप में भी काम करता है। वॉइस-नोट लक्ष्यों के लिए, OpenClaw प्रदाता-मूल ogg_opus का अनुरोध करता है। सामान्य ऑडियो अटैचमेंट के लिए, यह mp3 का अनुरोध करता है। प्रदाता उपनाम bytedance और doubao भी इसी स्पीच प्रदाता पर रिज़ॉल्व होते हैं। डिफ़ॉल्ट संसाधन आईडी seed-tts-1.0 है, यह वह एंटाइटलमेंट है जिसे BytePlus नई बनाई गई Seed Speech API कुंजियों को डिफ़ॉल्ट रूप से प्रदान करता है। यदि आपके प्रोजेक्ट में TTS 2.0 एंटाइटलमेंट है, तो VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 सेट करें।

VOLCANO_ENGINE_API_KEY, ModelArk/Doubao मॉडल एंडपॉइंट के लिए है और Seed Speech API कुंजी नहीं है। TTS को BytePlus Speech Console से Seed Speech API कुंजी या पुरानी Speech Console AppID/टोकन जोड़ी की आवश्यकता होती है।

पुराने Speech Console ऐप्लिकेशन के लिए पुराना AppID/टोकन प्रमाणीकरण अब भी समर्थित है:

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

अन्य वैकल्पिक TTS एनवायरनमेंट वेरिएबल: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY, और VOLCENGINE_TTS_BASE_URL सेट होने पर संबंधित tts.providers.volcengine कॉन्फ़िगरेशन फ़ील्ड को ओवरराइड करते हैं।

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

ऑनबोर्डिंग के बाद डिफ़ॉल्ट मॉडल

openclaw onboard --auth-choice volcengine-api-key, सामान्य volcengine कैटलॉग को भी पंजीकृत करते हुए volcengine-plan/ark-code-latest को डिफ़ॉल्ट मॉडल के रूप में सेट करता है।

मॉडल चयनकर्ता का फ़ॉलबैक व्यवहार

ऑनबोर्डिंग/कॉन्फ़िगरेशन मॉडल चयन के दौरान, Volcengine प्रमाणीकरण विकल्प volcengine/* और volcengine-plan/* दोनों पंक्तियों को प्राथमिकता देता है। यदि वे मॉडल अभी तक लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप वाला चयनकर्ता दिखाने के बजाय फ़िल्टर-रहित कैटलॉग पर फ़ॉलबैक करता है।

डेमन प्रक्रियाओं के लिए एनवायरनमेंट वेरिएबल

यदि Gateway डेमन (launchd/systemd) के रूप में चलता है, तो सुनिश्चित करें कि मॉडल और TTS एनवायरनमेंट वेरिएबल, जैसे VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID, और VOLCENGINE_TTS_TOKEN, उस प्रक्रिया के लिए उपलब्ध हों (उदाहरण के लिए, ~/.openclaw/.env में या env.shellEnv के माध्यम से)।

OpenClaw को पृष्ठभूमि सेवा के रूप में चलाते समय, आपके इंटरैक्टिव शेल में सेट किए गए एनवायरनमेंट वेरिएबल अपने-आप इनहेरिट नहीं होते। ऊपर दिया गया डेमन नोट देखें।

मॉडल चयन

प्रदाताओं, मॉडल संदर्भों और फ़ेलओवर व्यवहार का चयन।

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

एजेंट, मॉडल और प्रदाताओं के लिए पूर्ण कॉन्फ़िगरेशन संदर्भ।

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

सामान्य समस्याएँ और डीबगिंग चरण।

अक्सर पूछे जाने वाले प्रश्न

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

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

आरंभ करना

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

अंतर्निहित कैटलॉग

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

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

संबंधित

मॉडल चयन

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

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

अक्सर पूछे जाने वाले प्रश्न

​आरंभ करना

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

​अंतर्निहित कैटलॉग

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

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

​संबंधित

मॉडल चयन

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

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

अक्सर पूछे जाने वाले प्रश्न

आरंभ करना

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

अंतर्निहित कैटलॉग

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

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

संबंधित