Providers
Volcengine (Doubao)
يوفّر مزوّد Volcengine إمكانية الوصول إلى نماذج Doubao ونماذج الجهات الخارجية المستضافة على Volcano Engine، مع نقاط نهاية منفصلة لأعباء العمل العامة والبرمجية. ويسجّل Plugin المضمّن نفسه أيضًا Volcengine Speech كمزوّد لتحويل النص إلى كلام.
| التفصيل | القيمة |
|---|---|
| المزوّدون | volcengine (عام + تحويل النص إلى كلام)، وvolcengine-plan (برمجة) |
| مصادقة النموذج | VOLCANO_ENGINE_API_KEY |
| مصادقة تحويل النص إلى كلام | VOLCENGINE_TTS_API_KEY أو BYTEPLUS_SEED_SPEECH_API_KEY |
| API | نماذج متوافقة مع OpenAI، وتحويل النص إلى كلام عبر 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 يرفضها.
تحويل النص إلى كلام
يستخدم تحويل النص إلى كلام في Volcengine واجهة BytePlus Seed Speech HTTP API (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 افتراضيًا لمفاتيح Seed Speech API المنشأة حديثًا. إذا كان مشروعك يتمتع باستحقاق تحويل النص إلى كلام 2.0، فعيّن VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
تظل مصادقة AppID/الرمز المميز القديمة مدعومة لتطبيقات وحدة تحكم Speech الأقدم:
export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_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)، فتأكد من إتاحة متغيرات بيئة النموذج وتحويل النص إلى كلام، مثل VOLCANO_ENGINE_API_KEY وVOLCENGINE_TTS_API_KEY وBYTEPLUS_SEED_SPEECH_API_KEY وVOLCENGINE_TTS_APPID وVOLCENGINE_TTS_TOKEN، لتلك العملية (على سبيل المثال، في ~/.openclaw/.env أو عبر env.shellEnv).
