الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

يوفّر مزوّد Volcengine إمكانية الوصول إلى نماذج Doubao والنماذج التابعة لجهات خارجية المستضافة على Volcano Engine، مع نقاط نهاية منفصلة لأعباء العمل العامة وأعباء عمل البرمجة. ويمكن لـ Plugin المضمّن نفسه أيضًا تسجيل Volcengine Speech كمزوّد TTS.
التفاصيلالقيمة
المزوّداتvolcengine (عام + TTS) + volcengine-plan (للبرمجة)
مصادقة النموذجVOLCANO_ENGINE_API_KEY
مصادقة TTSVOLCENGINE_TTS_API_KEY أو BYTEPLUS_SEED_SPEECH_API_KEY
APIنماذج متوافقة مع OpenAI، وBytePlus Seed Speech TTS

​
البدء

1

تعيين مفتاح API

شغّل الإعداد التفاعلي:
openclaw onboard --auth-choice volcengine-api-key
يسجّل هذا كِلَا المزوّدين العام (volcengine) ومزوّد البرمجة (volcengine-plan) باستخدام مفتاح API واحد.
2

تعيين نموذج افتراضي

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

التحقق من توفر النموذج

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"

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

المزوّدنقطة النهايةحالة الاستخدام
volcengineark.cn-beijing.volces.com/api/v3النماذج العامة
volcengine-planark.cn-beijing.volces.com/api/coding/v3نماذج البرمجة
يتم إعداد كلا المزوّدين باستخدام مفتاح API واحد. ويسجّل الإعداد كليهما تلقائيًا.

​
الفهرس المضمّن

مرجع النموذجالاسمالإدخالالسياق
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8نص، صورة256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028نص، صورة256,000
volcengine/kimi-k2-5-260127Kimi K2.5نص، صورة256,000
volcengine/glm-4-7-251222GLM 4.7نص، صورة200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2نص، صورة128,000

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

يستخدم Volcengine TTS واجهة BytePlus Seed Speech HTTP API، ويتم إعداده بشكل منفصل عن مفتاح 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,
        },
      },
    },
  },
}
بالنسبة إلى أهداف الملاحظات الصوتية، يطلب OpenClaw من Volcengine تنسيق ogg_opus الأصلي الخاص بالمزوّد. وبالنسبة إلى مرفقات الصوت العادية، يطلب تنسيق mp3. كما تُحل الأسماء البديلة للمزوّد bytedance وdoubao إلى مزوّد الكلام نفسه. المعرّف الافتراضي للمورد هو seed-tts-1.0 لأن هذا هو المورد الذي تمنحه BytePlus لمفاتيح API الجديدة الخاصة بـ Seed Speech في المشروع الافتراضي. إذا كان مشروعك يملك صلاحية TTS 2.0، فعيّن VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
إن VOLCANO_ENGINE_API_KEY مخصّص لنقاط نهاية نماذج ModelArk/Doubao، وليس مفتاح API لـ Seed Speech. يحتاج TTS إلى مفتاح API لـ Seed Speech من وحدة تحكم BytePlus Speech، أو إلى زوج AppID/رمز قديم من Speech Console.
لا يزال دعم المصادقة القديمة باستخدام AppID/الرمز متاحًا لتطبيقات Speech Console الأقدم: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
الإعدادات المتقدمة

يعيّن openclaw onboard --auth-choice volcengine-api-key حاليًا volcengine-plan/ark-code-latest كنموذج افتراضي، مع تسجيل الفهرس العام volcengine أيضًا.
أثناء الإعداد أو اختيار النموذج في التهيئة، يفضّل خيار مصادقة Volcengine الصفوف volcengine/* وvolcengine-plan/* معًا. وإذا لم تكن هذه النماذج محمّلة بعد، فسيرجع OpenClaw إلى الفهرس غير المصفّى بدلًا من عرض منتقي فارغ مقيّد بنطاق المزوّد.
إذا كانت Gateway تعمل كعملية daemon (‏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 كخدمة في الخلفية، لا يتم توريث متغيرات البيئة المضبوطة في الصدفة التفاعلية تلقائيًا. راجع ملاحظة daemon أعلاه.

​
ذو صلة

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

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

الإعدادات

المرجع الكامل لإعدادات الوكلاء، والنماذج، والمزوّدات.

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

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

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

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