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 volcengine
openclaw models list --provider volcengine-plan

للإعداد غير التفاعلي (في CI أو البرمجة النصية)، مرّر المفتاح مباشرةً:

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)
البرمجة (volcengine-plan)

مرجع النموذج	الاسم	الإدخال	السياق
`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
`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.

المفتاح VOLCANO_ENGINE_API_KEY مخصّص لنقاط نهاية نماذج ModelArk/Doubao، وليس مفتاح Seed Speech API. يتطلب تحويل النص إلى كلام مفتاح Seed Speech API من وحدة تحكم BytePlus Speech، أو زوج AppID/رمز مميز قديمًا من وحدة تحكم Speech.

تظل مصادقة 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).

عند تشغيل OpenClaw كخدمة في الخلفية، لا تُورّث متغيرات البيئة المعيّنة في الصدفة التفاعلية تلقائيًا. راجع ملاحظة البرنامج الخفي أعلاه.

ذو صلة

اختيار النموذج

اختيار المزوّدين ومراجع النماذج وسلوك تجاوز الفشل.

الضبط

مرجع الضبط الكامل للوكلاء والنماذج والمزوّدين.

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة وخطوات تصحيح الأخطاء.

الأسئلة الشائعة

الأسئلة الشائعة حول إعداد OpenClaw.

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

بدء الاستخدام

المزوّدون ونقاط النهاية

الكتالوج المضمّن

تحويل النص إلى كلام

الضبط المتقدم

ذو صلة

اختيار النموذج

الضبط

استكشاف الأخطاء وإصلاحها

الأسئلة الشائعة

​بدء الاستخدام

​المزوّدون ونقاط النهاية

​الكتالوج المضمّن

​تحويل النص إلى كلام

​الضبط المتقدم

​ذو صلة

اختيار النموذج

الضبط

استكشاف الأخطاء وإصلاحها

الأسئلة الشائعة

بدء الاستخدام

المزوّدون ونقاط النهاية

الكتالوج المضمّن

تحويل النص إلى كلام

الضبط المتقدم

ذو صلة