Skip to content

ربط Tencent Hunyuan وBaidu Qianfan: تطبيق عملي لـ MaaS من كبرى الشركات ​

OpenClaw ربط Hunyuan وBaidu Qianfan هو المحطة السابعة في صفحة النماذج المحلية، وتتناول هذه الصفحة جهتين في درس واحد: Tencent Hunyuan (نقطتا النهاية TokenHub / TokenPlan) وBaidu Qianfan (Qianfan MaaS). لكل جهة إضافتها ومفتاحها الخاص، لكن طريقة الربط مطابقة تمامًا للدروس السابقة.

DeepSeek وQwen وGLM وKimi وMiniMax وDoubao — الخطوات الثلاث «تثبيت الإضافات ← إعداد بيانات الاعتماد ← اختيار النموذج» تنطبق كالمعتاد في هذا الدرس. تستغرق العملية بأكملها حوالي 10 دقيقة (باستثناء تسجيل حساب Tencent Cloud / Baidu AI Cloud).

إليك أولًا جدولًا إجماليًا، جميع الإعدادات في هذا الدرس تنطلق منه (الخصائص والقيم منقولة كما هي من الوثائق الرسمية):

Tencent HunyuanBaidu Qianfan
الإضافة@openclaw/tencent-provider@openclaw/qianfan-provider
معرّف Providertencent-tokenhub وtencent-tokenplanqianfan
المصادقةTOKENHUB_API_KEY / TOKENPLAN_API_KEYQIANFAN_API_KEY (بصيغة bce-v3/ALTAK-...)
نقطة النهايةhttps://tokenhub.tencentmaas.com/v1 (TokenHub)
https://api.lkeap.cloud.tencent.com/plan/v3 (TokenPlan)
https://qianfan.baidubce.com/v2
APIمتوافق مع OpenAI (openai-completions)نفس ما سبق
الافتراضي في onboardingtencent-tokenhub/hy4-preview (على جانب TokenPlan يُختار hy4-preview أيضًا)qianfan/deepseek-v4-pro

موقع الجهتين في سطرين:

  • Tencent Hunyuan: النماذج هي سلسلة Hunyuan hy (hy4-preview وhy3)، والمدخل هو نقطتا النهاية TokenHub وTokenPlan على Tencent Cloud، ولكل provider مفتاحه الخاص
  • Baidu Qianfan: منصة تجميع MaaS، مفتاح واحد يُوجَّه عبر API موحد إلى Wenxin ERNIE وDeepSeek المستضاف على Qianfan وغيرهما من نماذج عدة جهات

💡 للقادمين عبر البحث من «OpenClaw ربط Wenxin»

Wenxin (ERNIE) هي سلسلة نماذج Baidu، ويتم ربط OpenClaw عبر منصة MaaS وهي Baidu Qianfan — خلف API الموحد لـ Qianfan لا يوجد Wenxin فقط، بل أيضًا DeepSeek المستضاف على Qianfan. ملاحظة: OpenClaw كتالوج Baidu Qianfan يضم فقط ernie-5.1 وernie-5.0، أما ERNIE 4.5 وX1 والإصدارات الأقدم فغير موجودة فيه (تنبيه المشكلات في نهاية الدرس يقدم بدائل).

يستند هذا الدرس إلى OpenClaw v2026.10.9.

ماذا ستستطيع فعله بعد إتمام الدرس ​

  • تثبيت الإضافتين الرسميتين @openclaw/tencent-provider و@openclaw/qianfan-provider، وتسجيل الـ providers الثلاثة tencent-tokenhub وtencent-tokenplan وqianfan
  • التمييز بين نقطتَي النهاية من Tencent: لكل من TokenHub وTokenPlan متغير مفتاح خاص به، ويُشغَّل onboarding لكل منهما على حدة
  • OpenClaw Baidu Qianfan بمفتاح QIANFAN_API_KEY واحد يوجّه إلى Wenxin ERNIE وDeepSeek المستضاف على Qianfan
  • فهم كتالوج الجهتين: Hunyuan hy4-preview (سياق 1M) وWenxin ernie-5.1 (الرائد نصيًا) / ernie-5.0 (متعدد الوسائط) — سياق كل منها وأقصى إخراج لها
  • تجنّب المشكلات الخاصة بـ MaaS من كبرى الشركات: نطاق المفتاح المقيّد يُفقد نماذج، أسماء نماذج Hunyuan القديمة غير متاحة، صيغة مفتاح Baidu، المعرّفات المهملة
  • تهيئة نظام الذاكرة في OpenClaw بنموذج تضمين صيني من Qianfan (bge-large-zh)

🎒 التحضيرات قبل البدء ​

  • إتمام نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج: الإلمام بالخطوات الثلاث «provider ← المصادقة ← اختيار النموذج» وقاعدة مرجع provider/model
  • OpenClaw مثبَّت، وGateway يعمل: openclaw gateway status يعطي مخرجات
  • لديك حساب Tencent Cloud (مع Hunyuan) أو حساب Baidu AI Cloud (مع Qianfan) — واحد منهما على الأقل؛ فالمنصتان مستقلتان تمامًا، ولا مشكلة إطلاقًا في إعداد واحدة فقط
  • إذا اخترت النشر عبر خادم / daemon، فاعرف مكان ~/.openclaw/.env — فالمفتاح سيستقر هناك في النهاية

نفّذ معي ​

الخطوة 1: تثبيت إضافتي provider لـ Tencent Hunyuan وBaidu Qianfan ​

لماذا: مثل DeepSeek وDoubao، فإن tencent وqianfan كلاهما إضافات رسمية خارجية، ولا يأتي OpenClaw معهما مدمجًا — بعد تثبيت الإضافة، يُسجَّل الـ provider في منظومة النماذج. والمنصتان مستقلتان تمامًا، فيكفي أن تثبّت التي تحتاجها فقط.

bash
# 1. 安装腾讯混元 provider 插件(TokenHub + TokenPlan 两个 provider 一起注册)
openclaw plugins install @openclaw/tencent-provider

# 2. 安装百度千帆 provider 插件
openclaw plugins install @openclaw/qianfan-provider

# 3. 重启 Gateway(Gateway 正在跑的话,安装会自动生效;重启最稳妥)
openclaw gateway restart

ينبغي أن ترى: رسالة نجاح تثبيت الإضافة، وعدم ظهور أي خطأ بعد إعادة تشغيل Gateway.

سلوكٌ واحد اعرفه مسبقًا (مذكور صراحةً في وثائق الإضافة الرسمية): التثبيت يسري تلقائيًا على Gateway قيد التشغيل؛ وإذا لم يكن Gateway يعمل، فيسري عند الإقلاع التالي.

  • openclaw plugins install نُفِّذ بنجاح (ثُبِّتتا كلتاهما، أو ثُبِّتت فقط التي تحتاجها)، وأُعيد تشغيل Gateway

الخطوة 2: ربط OpenClaw بـ Hunyuan — إعداد نقطتي النهاية TokenHub / TokenPlan ​

لماذا: لـ Tencent Hunyuan مدخلان في OpenClaw — TokenHub (tencent-tokenhub) وTokenPlan (tencent-tokenplan)، يقابلان نقطتي نهاية منتجي Tencent Cloud MaaS. ولكل من الـ providerين متغيرات Key ومدخل onboarding خاصان به، فيجب تشغيل كل منهما مرة على حدة.

اذهب أولًا إلى وحدة تحكم Tencent Cloud وأنشئ API Key. تشترط الوثائق الرسمية صراحةً: إذا اخترت عند إنشاء Key نطاق وصول مقيَّدًا (access scope)، فيجب أن تتضمن قائمة النماذج المسموح بها hy4 preview — وإذا كنت تخطط لاستخدام سلسلة hy3 على TokenHub، فأضِف أيضًا hy3 / hy3 preview.

ثم شغّل onboarding (مرة لكل نقطة نهاية، كما في الوثائق الرسمية حرفيًا):

bash
# TokenHub 端点
openclaw onboard --auth-choice tokenhub-api-key

# TokenPlan 端点
openclaw onboard --auth-choice tokenplan-api-key

ينبغي أن ترى: نجاح التحقق من المفتاح وحفظه. تنص الوثائق الرسمية صراحةً: عند onboarding جديد كليًا على نقطتي النهاية كلتيهما يُختار hy4-preview كنموذج افتراضي؛ وستُحفظ مدخلات النماذج الموجودة لديك دون الكتابة فوقها.

في السيناريوهات غير التفاعلية مثل CI / السكربتات، تقدم الوثائق الرسمية صيغة تمرير المفتاح مباشرةً (كما هي):

bash
# TokenHub
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY" \
  --skip-health \
  --accept-risk

# TokenPlan
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY" \
  --skip-health \
  --accept-risk

إذا كنت لا ترغب في تشغيل onboarding، يكفي تعيين متغيرات البيئة (كما في الوثائق الرسمية حرفيًا):

bash
export TOKENHUB_API_KEY="<你的 TokenHub Key>"
export TOKENPLAN_API_KEY="<你的 TokenPlan Key>"

::: تحذير ⚠️ هل يعمل Gateway كـ daemon؟ لا تضع المفتاح في shell تفاعلي عندما يعمل Gateway كخدمة launchd / systemd، فإنه لا يرى متغيرات بيئة export في طرفيتك. اكتب TOKENHUB_API_KEY وTOKENPLAN_API_KEY في ~/.openclaw/.env، أو زوّد ذلك العملية عبر env.shellEnv في الإعدادات — وقد شددت وثائق tencent الرسمية على هذه النقطة تحديدًا. :::

وبالمناسبة، تحقق أن كلا الـ providerين قد سُجِّلا:

bash
openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan

ينبغي أن ترى: عائلتَي النماذج tencent-tokenhub/ وtencent-tokenplan/ كلتاهما مدرجتان (للجدول التفصيلي انظر الخطوة 4).

وهناك قاعدة ترحيل رسمية للمستخدمين الحاليين، احفظها أولًا: لن تُرقّى إعدادات TokenHub الموجودة تلقائيًا إلى Hy4. وعند وجود قائمة نماذج مسموح بها (allowlist)، فإن openclaw doctor --fix سيغيّر فقط النموذج الرئيسي المهجور tencent-tokenhub/hy3-preview إلى tencent-tokenhub/hy3.

رغم أن توصية الجدول لـ hy3-preview هي hy4-preview، فإن Doctor لا ينفّذ هذا الترحيل — فالترقية إلى Hy4 إجراء صريح، وعليك بنفسك التحقق من صلاحيات الوصول إلى النماذج في نقطة النهاية المختارة ومن فروق الأسعار.

  • يمكنك رؤية مصدر بيانات اعتماد tencent في openclaw models status

الخطوة 3: ربط OpenClaw بـ Baidu Qianfan — إعداد QIANFAN_API_KEY ​

لماذا: Qianfan هي منصة MaaS التابعة لـ Baidu — واجهة API موحّدة متوافقة مع OpenAI، ومفتاح واحد يوجّه الطلبات إلى نماذج متعددة خلف نقطة النهاية. ولديها provider واحد فقط: qianfan، تكفي تهيئته مرة واحدة لتعمل كل الأمور.

اذهب أولًا إلى وحدة تحكم Qianfan وأنشئ مفتاحًا (رابط مباشر من الوثائق الرسمية):

  1. سجِّل / سجّل الدخول إلى Baidu AI Cloud، وادخل إلى وحدة تحكم Qianfan، وفعّل الوصول إلى Qianfan API
  2. أنشئ تطبيقًا جديدًا (أو اختر تطبيقًا موجودًا)، وولّد API Key — مفتاح Baidu Cloud يبدو هكذا: bce-v3/ALTAK-...

ثم شغّل onboarding:

bash
openclaw onboard --auth-choice qianfan-api-key

ينبغي أن ترى: نجاح التحقق من المفتاح وحفظه. تنص الوثائق الرسمية صراحةً على أن onboarding يفعل ثلاثة أمور: كتابة إعدادات الـ provider، وإضافة الاسم المستعار QIANFAN للنموذج الافتراضي، وتعيين qianfan/deepseek-v4-pro كافتراضي إذا لم تكن قد ضبطت نموذجًا افتراضيًا من قبل. تُحفظ إعدادات الاتصال والأسماء المستعارة، لكن لن تُنسخ صفوف الجدول المولَّدة إلى إعداداتك.

في السيناريوهات غير التفاعلية، يُقرأ --qianfan-api-key <key> أو متغير البيئة QIANFAN_API_KEY (كما في الوثائق الرسمية حرفيًا):

bash
export QIANFAN_API_KEY="bce-v3/ALTAK-<你的 Key>"

وبالمناسبة، تحقق:

bash
openclaw models list --provider qianfan

ينبغي أن ترى: جدول النماذج ذا البادئة qianfan/ مدرجًا (للتفاصيل انظر الخطوة 4). وإذا كانت القائمة فارغة، فتحقق أولًا من البندين الأولين في قائمة استكشاف الأخطاء الرسمية: هل يبدأ المفتاح بـ bce-v3/ALTAK-، وهل خدمة Qianfan مفعّلة في وحدة تحكم Baidu Cloud.

  • openclaw models list --provider qianfan يستطيع سرد الجدول

الخطوة 4: اختيار نموذج Hunyuan / Wenxin والتحقق ​

لماذا: جدولا المنصتين ليسا طويلين، لكن لكل منهما تفاصيله — فلدى Hunyuan ثلاثة معرفات فقط من سلسلة hy، بينما Qianfan جدول ثابت (لا يعتمد الاكتشاف عبر الإنترنت) وتكمن فيه معرفات قديمة مهجورة، والاختيار الخاطئ يوقعك في مطبات.

لننظر أولًا إلى جدول Tencent Hunyuan (منسَّق كما في الوثائق الرسمية):

مرجع النموذجالاسمالمدخلاتالسياقأقصى مخرجاتملاحظات
tencent-tokenhub/hy4-previewhy4 preview (TokenHub)نص1,024,00064,000reasoning؛ الافتراضي
tencent-tokenhub/hy3hy3 (TokenHub)نص256,000128,000reasoning؛ الجيل السابق GA
tencent-tokenhub/hy3-previewhy3 preview (TokenHub)نص256,000128,000مهجور؛ استخدم hy4-preview
tencent-tokenplan/hy4-previewhy4 preview (TokenPlan)نص1,024,00064,000reasoning؛ الافتراضي
tencent-tokenplan/hy3hy3 (TokenPlan)نص256,000128,000reasoning؛ الجيل السابق GA

hy4-preview هو نموذج MoE كبير من Hunyuan، موجّه للاستدلال واتباع التعليمات في السياقات الطويلة والبرمجة ومسارات عمل الـ agent؛ تستخدمه أمثلة Tencent المتوافقة مع OpenAI كـ model id، ويدعم استدعاء الأدوات القياسي عبر chat-completions بالإضافة إلى reasoning_effort.

والآن نلقي نظرة على دليل بايدو تشيانفان (مُرتَّب كما هو في الوثائق الرسمية):

مرجع النموذجالإدخالالسياقالحد الأقصى للإخراجReasoningملاحظات
qianfan/deepseek-v4-proنص1,000,000393,216نعمأحدث نموذج DeepSeek الرائد
qianfan/ernie-5.1نص128,00065,536لاأحدث نموذج وينكسين النصي الرائد
qianfan/ernie-5.0نص وصور128,00065,536نعممتعدد الوسائط + thinking
qianfan/deepseek-v3.2نص128,00032,768لاافتراضي متوافق مهمل؛ حل محله deepseek-v4-pro
qianfan/ernie-5.0-thinking-previewنص وصور128,00065,536نعماسم مستعار مهمل؛ حل محله ernie-5.0

دليل تشيانفان مدمج بشكل ثابت — النص الحرفي في الوثائق الرسمية «catalog is static; there is no live model discovery»، والنماذج الجديدة يجب أن تنتظر تحديث OpenClaw للإضافة إلى الدليل.

كيف تختار، في خمس جمل:

احتياجكاختر
تريد أحدث نموذج هونيوان الرائد، واستدلال بسياق 1Mtencent-tokenhub/hy4-preview (الافتراضي في onboarding)
الـ Key على نقطة TokenPlan النهائيةtencent-tokenplan/hy4-preview
تريد أحدث نموذج وينكسين النصي الرائدqianfan/ernie-5.1
تريد وينكسين بإدخال متعدد الوسائط + thinkingqianfan/ernie-5.0
الـ Key على تشيانفان وتريد فقط DeepSeekqianfan/deepseek-v4-pro (الافتراضي في onboarding)

تغيير النموذج الافتراضي:

bash
# 混元(注意前缀跟端点走)
openclaw models set tencent-tokenhub/hy4-preview

# 文心
openclaw models set qianfan/ernie-5.1

يمكن أيضًا التبديل مؤقتًا داخل الدردشة: /model qianfan/ernie-5.0 يؤثر فقط على الجلسة الحالية، وتفاصيل عائلة الأوامر في دليل سريع لأوامر الدردشة.

أخيرًا التحقق. أرسل رسالة اختبار:

bash
openclaw dashboard

افتح Control UI، وأرسل في مربع الدردشة جملة «قدّم نفسك في جملة واحدة».

يجب أن ترى: النموذج يرد بشكل طبيعي، دون أخطاء نقص بيانات الاعتماد أو عدم وجود النموذج. إلى هنا، يكون ربط OpenClaw بهونيوان وبايدو تشيانفان قد تم بنجاح.

السعر في جملة واحدة: وثائق TokenHub الرسمية لم تذكر سعرًا؛ وفي مثال إعداد تشيانفان، التقدير الدليلي لـ deepseek-v4-pro هو لكل مليون token: إدخال 1.771957 / إخراج 3.543915 / قراءة الكاش 0.147663 (أرقام دليل OpenClaw). الأسعار الفعلية والعملة تُعتمد دائمًا من مواقع Tencent Cloud وBaidu AI Cloud الرسمية.

  • رسالة الاختبار حصلت على رد، والمزوّد والنموذج متطابقان (tencent-tokenhub/... أو tencent-tokenplan/... أو qianfan/...)

نقاط التحقق ✅ ​

  • @openclaw/tencent-provider و@openclaw/qianfan-provider على الأقل ثبّت الذي ستستخدمه (يثبت مفعوله فور التثبيت)
  • هونيوان بنقطتين نهائيتين لكل منهما Key خاص: TOKENHUB_API_KEY (TokenHub) + TOKENPLAN_API_KEY (TokenPlan)
  • Key تشيانفان يبدأ بـ bce-v3/ALTAK-، وخدمة تشيانفان مفعّلة في وحدة تحكم Baidu AI Cloud
  • openclaw models list --provider tencent-tokenhub / --provider tencent-tokenplan / --provider qianfan جميعها تستطيع عرض الدليل
  • بادئة النموذج الافتراضي تناسب نقطة النهاية: هونيوان اكتب tencent-tokenhub/ أو tencent-tokenplan/، وتشيانفان اكتب qianfan/
  • رسالة الاختبار حصلت على رد

تنبيهات للمزالق ​

❌ نطاق تقييد Key هونيوان لا يشمل hy4 preview ​

الظاهرة: التحقق في onboarding لا ينجح، أو قائمة نماذج هونيوان ناقصة، أو الاستدعاء مرفوض.

السبب: عند إنشاء الـ Key في Tencent Cloud، إذا اخترت نطاق وصول مقيدًا، فإن قائمة النماذج المسموح بها لا تتضمن hy4 preview — والوثائق الرسمية تطلب صراحة إضافته (إلى جانب hy3 / hy3 preview المخطط لاستخدامهما في TokenHub) إلى قائمة السماح.

الحل الصحيح: عد إلى وحدة التحكم وعدّل نطاق النماذج المسموح بها للـ Key، أو استخدم Key آخر بنطاق كامل.

❌ استخدام أسماء نماذج هونيوان القديمة (hunyuan-turbo / hunyuan-larges وغيرها) ​

الظاهرة: خطأ نموذج غير معروف.

السبب: مزوّد هونيوان في OpenClaw يضم سلسلة hy فقط (hy4-preview وhy3 وhy3-preview) — الأسماء القديمة مثل hunyuan-turbo وhunyuan-larges غير موجودة في TokenHub / TokenPlan (مطابقة كاملة للمصادر بدون أي نتيجة).

الحل الصحيح: استخدم tencent-tokenhub/hy4-preview (الافتراضي) أو hy3؛ واحتياجات النماذج القديمة عبر نقطة النهاية المتوافقة المخصصة في الدرس التالي.

❌ تنسيق Key بايدو غير صحيح / خدمة تشيانفان غير مفعّلة ​

الظاهرة: قائمة openclaw models list --provider qianfan فارغة، أو الاستدعاء يُرجع خطأ بيانات اعتماد.

السبب: البندان الأولان من قائمة استكشاف الأخطاء الرسمية — يجب أن يبدأ الـ Key بـ bce-v3/ALTAK-؛ ويجب أن يكون الحساب قد فعّل وصول API تشيانفان في وحدة تحكم Baidu Cloud.

الحل الصحيح: عد إلى وحدة تحكم تشيانفان وتحقق من تنسيق الـ Key وحالة تفعيل الخدمة.

❌ البحث في دليل تشيانفان عن ERNIE 4.5 / X1 وغيرها من الطرازات الأقدم ​

السبب: دليل OpenClaw لتشيانفان يضم فقط ernie-5.1 وernie-5.0 (دليل ثابت، بدون اكتشاف مباشر).

الحل الصحيح: طرازات وينكسين الأقدم ليس لها مزوّد رسمي — استخدم مسار «نقطة نهاية مخصصة متوافقة مع OpenAI» في الدرس التالي، أو ابحث عن مسار مستضاف لدى موزعين مثل OpenRouter / NovitaAI.

❌ استخدام ID قديم مهمل ​

معرّف مهملالبديل
tencent-tokenhub/hy3-previewيوصي الدليل بـ hy4-preview؛doctor --fix ينقل فقط إلى hy3
qianfan/deepseek-v3.2qianfan/deepseek-v4-pro
qianfan/ernie-5.0-thinking-previewqianfan/ernie-5.0

الطريقة الصحيحة: استخدم البديل دائمًا في التهيئات الجديدة؛ وفي التهيئات القائمة شغّل openclaw doctor للاطلاع على التلميحات ثم قم بالترحيل.

❌ بعد تثبيت Gateway كـ daemon، لا يصبح مفتاح export «ساري المفعول» ​

السبب: خدمات launchd / systemd لا ترى متغيرات البيئة الخاصة بالـ shell التفاعلي — وتشدد وثائق tencent الرسمية على هذه النقطة تحديدًا (يجب تمرير متغيّري TokenHub و TokenPlan معًا إلى عملية الخدمة).

الطريقة الصحيحة: اكتب TOKENHUB_API_KEY وTOKENPLAN_API_KEY وQIANFAN_API_KEY في ~/.openclaw/.env، أو قدّمها عبر env.shellEnv؛ وبعد تغيير المفتاح أعد تشغيل خدمة Gateway.

❌ الاعتقاد بأن doctor --fix سيقوم بالترقية إلى Hy4 نيابةً عنك ​

السبب: قواعد الترحيل الرسمية — بالنسبة لتهيئات TokenHub القائمة المُعدّ لها allowlist، يقوم openclaw doctor --fix فقط بتغيير hy3-preview المهمل إلى hy3، ولا يقوم بتغييره إلى Hy4.

الطريقة الصحيحة: ترقية Hy4 تتم بشكل صريح بنفسك (openclaw models set tencent-tokenhub/hy4-preview)، مع التأكد أولًا من صلاحيات الوصول إلى النماذج في نقطة النهاية المختارة ومن فروق الأسعار.

❌ حساب دولي يتصل مباشرةً بنقطة نهاية داخلية (أو العكس) ​

السبب: نقطة النهاية المدمجة في TokenHub هي https://tokenhub.tencentmaas.com/v1؛ ونقطة النهاية للنسخة الدولية https://tokenhub-intl.tencentmaas.com/v1 تتطلب تجاوزًا صريحًا لـ baseUrl.

الطريقة الصحيحة: لحساب TokenHub الدولي تجاوز baseUrl وفق القسم التالي؛ وينطبق الأمر نفسه على Qianfan — عدّل base URL فقط عند استخدام نقطة نهاية مخصصة / وسيط.

🔧 متقدم: تجاوز نقاط النهاية وتضمين ذاكرة Qianfan (اختياري) ​

تجاوز نقطة نهاية TokenHub (نسخة دولية / منطقة خاصة) ​

الدليل المدمج يستخدم https://tokenhub.tencentmaas.com/v1. تجاوز ذلك فقط عندما يتطلب حساب TokenHub أو منطقتك نقطة نهاية مختلفة (المثال الرسمي كما هو، وهنا نأخذ نقطة النهاية الدولية كمثال):

bash
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"

تهيئة نموذج المتجهات الصيني من Qianfan لنظام الذاكرة ​

يحتاج استرجاع الذاكرة في OpenClaw إلى نموذج embedding، ويمكن لمكوّن Qianfan الإضافي أن يعمل مباشرةً كـ embedding provider — وهو مناسب بشكل خاص للمحتوى الصيني (المثال الرسمي كما هو):

json5
{
  memory: {
    search: {
      provider: "qianfan",
      model: "bge-large-zh",
    },
  },
}

ثلاثة تفاصيل (مذكورة صراحةً في الوثائق الرسمية):

  • يعيد المكوّن الإضافي استخدام اتصال Qianfan الذي هيّأته، وتُستخرج بيانات الاعتماد من الـ profile المحفوظ أو من QIANFAN_API_KEY؛ ومفتاح API البعيد أو ترويسة Authorization الصريحة لهما الأولوية
  • نماذج bge-large-zh وbge-large-en وEmbedding-V1 الثلاثة تقبل كحد أقصى 16 مدخلًا في كل طلب (اتباعًا لـ حدود الدُفعات الرسمية من Baidu)، أما النماذج الأخرى فتتبع السلوك القائم للنقل المتوافق
  • إذا كانت تهيئة قائمة لديك تستخدم openai-compatible للإشارة إلى Qianfan، فيكفي تغيير memory.search.provider إلى qianfan — مع بقاء نقطة النهاية والمفتاح دون تغيير

نظام الذاكرة نفسه موضّح في نظام الذاكرة: اجعل Claw يتذكرك.

اكتب models.providers فقط عند الحاجة إلى بيانات وصفية مخصصة ​

القاعدة الرسمية: يكفي تثبيت المكوّن الإضافي + تهيئة auth، ولا حاجة لكتابة مدخلات models.providers؛ اكتبها فقط عند تجاوز baseUrl أو بيانات النماذج الوصفية. التهيئة الصريحة الكاملة لـ Qianfan تبدو هكذا (مقتطف من المثال الرسمي كما هو):

json5
{
  env: { vars: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." } },
  agents: {
    defaults: {
      model: { primary: "qianfan/deepseek-v4-pro" },
      models: {
        "qianfan/deepseek-v4-pro": { alias: "QIANFAN" },
      },
    },
  },
  models: {
    providers: {
      qianfan: {
        baseUrl: "https://qianfan.baidubce.com/v2",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-v4-pro",
            name: "DeepSeek V4 Pro",
            reasoning: true,
            input: ["text"],
            cost: {
              input: 1.771957,
              output: 3.543915,
              cacheRead: 0.147663,
              cacheWrite: 0,
            },
            contextWindow: 1000000,
            maxTokens: 393216,
          },
        ],
      },
    },
  },
}

وهناك ملاحظة توافقية أخرى (بحسب معنى الوثائق الرسمية): يعمل Qianfan عبر مسار النقل المتوافق مع OpenAI، وليس عبر تشكيل طلبات OpenAI الأصلية — ميزات OpenAI SDK القياسية متاحة، لكن المعاملات الخاصة بـ provider قد لا تُمرَّر. وثائق Qianfan API الرسمية متاحة في cloud.baidu.com/doc/qianfan-api.

الخطوة التالية ​

بهذا تكتمل رحلة ربط OpenClaw بـ Hunyuan و Baidu Qianfan. تابع عبر صفحة النماذج المحلية المخصصة:

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.