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، TTS از BytePlus Seed Speech |
شروع به کار
تنظیم کلید API
فرایند راهاندازی تعاملی را اجرا کنید:
openclaw onboard --auth-choice volcengine-api-keyبا این کار، هر دو ارائهدهنده عمومی (volcengine) و کدنویسی (volcengine-plan) با یک کلید API ثبت میشوند.
تنظیم مدل پیشفرض
{ 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 را بهطور خودکار حذف میکنند، زیرا API فراخوانی ابزار Volcengine آنها را رد میکند.
تبدیل متن به گفتار
TTS در Volcengine از API مبتنی بر HTTP سرویس BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) استفاده میکند و جدا از کلید API مدل Doubao سازگار با OpenAI پیکربندی میشود. در کنسول 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 بهطور پیشفرض به کلیدهای API تازهساختهشده Seed Speech اعطا میکند. اگر پروژه شما مجوز TTS 2.0 دارد، VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 را تنظیم کنید.
احراز هویت قدیمی AppID/توکن برای برنامههای قدیمیتر Speech Console همچنان پشتیبانی میشود:
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).
