Providers
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 volcengineopenclaw models list --provider volcengine-planप्रदाता और एंडपॉइंट
| प्रदाता | एंडपॉइंट | उपयोग का मामला |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
सामान्य मॉडल |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
कोडिंग मॉडल |
अंतर्निहित कैटलॉग
सामान्य (volcengine)
| मॉडल संदर्भ | नाम | इनपुट | संदर्भ |
|---|---|---|---|
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)
| मॉडल संदर्भ | नाम | इनपुट | संदर्भ |
|---|---|---|---|
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 सेट करें।
पुराने 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 के माध्यम से)।