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 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | متن | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | متن | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | متن | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | متن | 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 فعال کنید:
{ messages: { tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "byteplus_seed_speech_api_key", voice: "en_female_anna_mars_bigtts", speedRatio: 1.0, }, }, }, },}فیلدهای موجود در messages.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 که در صورت تنظیم، فیلدهای پیکربندی متناظر در messages.tts.providers.volcengine را بازنویسی میکنند.
پیکربندی پیشرفته
مدل پیشفرض پس از راهاندازی اولیه
فرمان openclaw onboard --auth-choice volcengine-api-key مدل volcengine-plan/ark-code-latest را بهعنوان مدل پیشفرض تنظیم میکند و همزمان فهرست عمومی volcengine را نیز ثبت میکند.
رفتار جایگزین انتخابگر مدل
هنگام انتخاب مدل در فرایند راهاندازی اولیه یا پیکربندی، گزینه احراز هویت 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).
