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، وBytePlus Seed Speech TTS

البدء

  • تعيين مفتاح 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
    
  • المزوّدات ونقاط النهاية

    المزوّد نقطة النهاية حالة الاستخدام
    volcengine ark.cn-beijing.volces.com/api/v3 النماذج العامة
    volcengine-plan ark.cn-beijing.volces.com/api/coding/v3 نماذج البرمجة

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

    عام (volcengine)

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

    لا يزال دعم المصادقة القديمة باستخدام 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 إلى الفهرس غير المصفّى بدلًا من عرض منتقي فارغ مقيّد بنطاق المزوّد.

    متغيرات البيئة لعمليات daemon

    إذا كانت 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).

    ذو صلة