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

Volcengine (Doubao)

يوفّر مزوّد Volcengine الوصول إلى نماذج Doubao والنماذج الخارجية المستضافة على Volcano Engine، مع نقاط نهاية منفصلة للأحمال العامة وأحمال البرمجة.
التفاصيلالقيمة
المزوّدونvolcengine (عام) + volcengine-plan (برمجة)
المصادقةVOLCANO_ENGINE_API_KEY
APIمتوافق مع OpenAI

البدء

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

ملاحظات متقدمة

يضبط openclaw onboard --auth-choice volcengine-api-key حاليًا volcengine-plan/ark-code-latest كنموذج افتراضي، مع تسجيل كتالوج volcengine العام أيضًا.
أثناء الإعداد/ضبط اختيار النموذج، يفضّل خيار مصادقة Volcengine الصفوف volcengine/* وvolcengine-plan/* معًا. وإذا لم تكن تلك النماذج قد تم تحميلها بعد، يعود OpenClaw إلى الكتالوج غير المفلتر بدلًا من عرض منتقٍ فارغ للنماذج على مستوى المزوّد.
إذا كان Gateway يعمل كخدمة daemon (launchd/systemd)، فتأكد من أن VOLCANO_ENGINE_API_KEY متاح لتلك العملية (على سبيل المثال، في ~/.openclaw/.env أو عبر env.shellEnv).
عند تشغيل OpenClaw كخدمة في الخلفية، لا تُورَّث متغيرات البيئة المضبوطة في الـ shell التفاعلي تلقائيًا. راجع ملاحظة daemon أعلاه.

ذو صلة

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

اختيار المزوّدين، ومراجع النماذج، وسلوك التبديل الاحتياطي.

الإعداد

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

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

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

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

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