ربط 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 Hunyuan | Baidu Qianfan | |
|---|---|---|
| الإضافة | @openclaw/tencent-provider | @openclaw/qianfan-provider |
| معرّف Provider | tencent-tokenhub وtencent-tokenplan | qianfan |
| المصادقة | TOKENHUB_API_KEY / TOKENPLAN_API_KEY | QIANFAN_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) | نفس ما سبق |
| الافتراضي في onboarding | tencent-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) وWenxinernie-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 في منظومة النماذج. والمنصتان مستقلتان تمامًا، فيكفي أن تثبّت التي تحتاجها فقط.
# 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 (مرة لكل نقطة نهاية، كما في الوثائق الرسمية حرفيًا):
# TokenHub 端点
openclaw onboard --auth-choice tokenhub-api-key
# TokenPlan 端点
openclaw onboard --auth-choice tokenplan-api-keyينبغي أن ترى: نجاح التحقق من المفتاح وحفظه. تنص الوثائق الرسمية صراحةً: عند onboarding جديد كليًا على نقطتي النهاية كلتيهما يُختار hy4-preview كنموذج افتراضي؛ وستُحفظ مدخلات النماذج الموجودة لديك دون الكتابة فوقها.
في السيناريوهات غير التفاعلية مثل CI / السكربتات، تقدم الوثائق الرسمية صيغة تمرير المفتاح مباشرةً (كما هي):
# 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، يكفي تعيين متغيرات البيئة (كما في الوثائق الرسمية حرفيًا):
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ين قد سُجِّلا:
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 وأنشئ مفتاحًا (رابط مباشر من الوثائق الرسمية):
- سجِّل / سجّل الدخول إلى Baidu AI Cloud، وادخل إلى وحدة تحكم Qianfan، وفعّل الوصول إلى Qianfan API
- أنشئ تطبيقًا جديدًا (أو اختر تطبيقًا موجودًا)، وولّد API Key — مفتاح Baidu Cloud يبدو هكذا:
bce-v3/ALTAK-...
ثم شغّل onboarding:
openclaw onboard --auth-choice qianfan-api-keyينبغي أن ترى: نجاح التحقق من المفتاح وحفظه. تنص الوثائق الرسمية صراحةً على أن onboarding يفعل ثلاثة أمور: كتابة إعدادات الـ provider، وإضافة الاسم المستعار QIANFAN للنموذج الافتراضي، وتعيين qianfan/deepseek-v4-pro كافتراضي إذا لم تكن قد ضبطت نموذجًا افتراضيًا من قبل. تُحفظ إعدادات الاتصال والأسماء المستعارة، لكن لن تُنسخ صفوف الجدول المولَّدة إلى إعداداتك.
في السيناريوهات غير التفاعلية، يُقرأ --qianfan-api-key <key> أو متغير البيئة QIANFAN_API_KEY (كما في الوثائق الرسمية حرفيًا):
export QIANFAN_API_KEY="bce-v3/ALTAK-<你的 Key>"وبالمناسبة، تحقق:
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-preview | hy4 preview (TokenHub) | نص | 1,024,000 | 64,000 | reasoning؛ الافتراضي |
tencent-tokenhub/hy3 | hy3 (TokenHub) | نص | 256,000 | 128,000 | reasoning؛ الجيل السابق GA |
tencent-tokenhub/hy3-preview | hy3 preview (TokenHub) | نص | 256,000 | 128,000 | مهجور؛ استخدم hy4-preview |
tencent-tokenplan/hy4-preview | hy4 preview (TokenPlan) | نص | 1,024,000 | 64,000 | reasoning؛ الافتراضي |
tencent-tokenplan/hy3 | hy3 (TokenPlan) | نص | 256,000 | 128,000 | reasoning؛ الجيل السابق GA |
hy4-preview هو نموذج MoE كبير من Hunyuan، موجّه للاستدلال واتباع التعليمات في السياقات الطويلة والبرمجة ومسارات عمل الـ agent؛ تستخدمه أمثلة Tencent المتوافقة مع OpenAI كـ model id، ويدعم استدعاء الأدوات القياسي عبر chat-completions بالإضافة إلى reasoning_effort.
والآن نلقي نظرة على دليل بايدو تشيانفان (مُرتَّب كما هو في الوثائق الرسمية):
| مرجع النموذج | الإدخال | السياق | الحد الأقصى للإخراج | Reasoning | ملاحظات |
|---|---|---|---|---|---|
qianfan/deepseek-v4-pro | نص | 1,000,000 | 393,216 | نعم | أحدث نموذج DeepSeek الرائد |
qianfan/ernie-5.1 | نص | 128,000 | 65,536 | لا | أحدث نموذج وينكسين النصي الرائد |
qianfan/ernie-5.0 | نص وصور | 128,000 | 65,536 | نعم | متعدد الوسائط + thinking |
qianfan/deepseek-v3.2 | نص | 128,000 | 32,768 | لا | افتراضي متوافق مهمل؛ حل محله deepseek-v4-pro |
qianfan/ernie-5.0-thinking-preview | نص وصور | 128,000 | 65,536 | نعم | اسم مستعار مهمل؛ حل محله ernie-5.0 |
دليل تشيانفان مدمج بشكل ثابت — النص الحرفي في الوثائق الرسمية «catalog is static; there is no live model discovery»، والنماذج الجديدة يجب أن تنتظر تحديث OpenClaw للإضافة إلى الدليل.
كيف تختار، في خمس جمل:
| احتياجك | اختر |
|---|---|
| تريد أحدث نموذج هونيوان الرائد، واستدلال بسياق 1M | tencent-tokenhub/hy4-preview (الافتراضي في onboarding) |
| الـ Key على نقطة TokenPlan النهائية | tencent-tokenplan/hy4-preview |
| تريد أحدث نموذج وينكسين النصي الرائد | qianfan/ernie-5.1 |
| تريد وينكسين بإدخال متعدد الوسائط + thinking | qianfan/ernie-5.0 |
| الـ Key على تشيانفان وتريد فقط DeepSeek | qianfan/deepseek-v4-pro (الافتراضي في onboarding) |
تغيير النموذج الافتراضي:
# 混元(注意前缀跟端点走)
openclaw models set tencent-tokenhub/hy4-preview
# 文心
openclaw models set qianfan/ernie-5.1يمكن أيضًا التبديل مؤقتًا داخل الدردشة: /model qianfan/ernie-5.0 يؤثر فقط على الجلسة الحالية، وتفاصيل عائلة الأوامر في دليل سريع لأوامر الدردشة.
أخيرًا التحقق. أرسل رسالة اختبار:
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.2 | qianfan/deepseek-v4-pro |
qianfan/ernie-5.0-thinking-preview | qianfan/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 أو منطقتك نقطة نهاية مختلفة (المثال الرسمي كما هو، وهنا نأخذ نقطة النهاية الدولية كمثال):
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"تهيئة نموذج المتجهات الصيني من Qianfan لنظام الذاكرة
يحتاج استرجاع الذاكرة في OpenClaw إلى نموذج embedding، ويمكن لمكوّن Qianfan الإضافي أن يعمل مباشرةً كـ embedding provider — وهو مناسب بشكل خاص للمحتوى الصيني (المثال الرسمي كما هو):
{
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 تبدو هكذا (مقتطف من المثال الرسمي كما هو):
{
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. تابع عبر صفحة النماذج المحلية المخصصة:
- الدرس التالي مزيد من النماذج الصينية ونقاط النهاية الوسيطة المخصصة: نماذج مثل Spark و Baichuan التي لا تملك provider رسميًا، إضافةً إلى طرق استخدام OpenRouter / LiteLLM / النقاط الوسيطة المخصصة
- صفحات النماذج الأخرى (النماذج المحلية) تبدأ من جدول الدروس في نظرة عامة على ربط النماذج
- هل هيّأت النماذج؟ الاستخدام اليومي يبدأ من الاستخدام اليومي: تعامل بكفاءة مع Claw الخاص بك — واجهة التحكم Control UI وأوامر الدردشة ونظام الذاكرة كلها في ذلك الفصل
دروس ذات صلة
- النماذج المحلية: Ollama و vLLM و ds4
- WeChat و QQ و Yuanbao: ربط قنوات Tencent — النموذج هو Tencent Hunyuan، وقنوات الدردشة أيضًا يمكن أن تكون على تطبيقات Tencent للمراسلة الفورية
- نظام الذاكرة: اجعل Claw يتذكرك