---
read_when:
- आप OpenClaw के साथ Volcano Engine या Doubao मॉडल का उपयोग करना चाहते हैं
- आपको Volcengine API कुंजी सेटअप की आवश्यकता है
- आप Volcengine Speech टेक्स्ट-टू-स्पीच का उपयोग करना चाहते हैं
summary: Volcano Engine सेटअप (Doubao मॉडल, कोडिंग एंडपॉइंट और Seed Speech TTS)
title: Volcengine (Doubao)
x-i18n:
generated_at: "2026-07-27T18:28:43Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 32
provider: openai
source_hash: 89538772b704499547ecf0274c5bb9bf8f68cc267dc7f484d3236921a9c89681
source_path: providers/volcengine.md
workflow: 16
---
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 |
## आरंभ करना
इंटरैक्टिव ऑनबोर्डिंग चलाएँ:
```bash
openclaw onboard --auth-choice volcengine-api-key
```
यह एक ही API कुंजी से सामान्य (`volcengine`) और कोडिंग (`volcengine-plan`) दोनों प्रदाताओं को पंजीकृत करता है।
```json5
{
agents: {
defaults: {
model: { primary: "volcengine-plan/ark-code-latest" },
},
},
}
```
```bash
openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
```
गैर-इंटरैक्टिव सेटअप (CI, स्क्रिप्टिंग) के लिए, कुंजी सीधे पास करें:
```bash
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/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 कुंजी कॉपी करें, फिर सेट करें:
```bash
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
```
फिर इसे `openclaw.json` में सक्षम करें:
```json5
{
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=` इनलाइन वॉइस निर्देश के रूप में भी काम करता है।
वॉइस-नोट लक्ष्यों के लिए, 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/टोकन प्रमाणीकरण अब भी समर्थित है:
```bash
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 सेटअप के बारे में अक्सर पूछे जाने वाले प्रश्न।