الاندماج مع DeepSeek: دليل عملي لإعداد نماذج سلسلة V4
OpenClaw الاندماج مع DeepSeek هو المحطة الأولى في صفحة النماذج المحلية، وهو أيضًا الأسهل: واجهة API متوافقة مع OpenAI، ومتغير بيئة واحد، وأمر onboarding واحد. الخطوات الثلاث من الدرس السابق «تثبيت الإضافة ← إعداد بيانات الاعتماد ← اختيار النموذج» سنمر بها كاملة في هذا الدرس، وتستغرق حوالي 8 دقائق (دون احتساب تسجيل حساب DeepSeek).
إليك أولًا جدولًا سريعًا تنطلق منه كل إعدادات هذا الدرس:
| الخاصية | القيمة |
|---|---|
| معرّف provider | deepseek |
| متغير بيئة المصادقة | DEEPSEEK_API_KEY |
| شكل واجهة API | متوافق مع OpenAI |
| Base URL | https://api.deepseek.com |
| الإضافة الرسمية | @openclaw/deepseek-provider (إضافة خارجية، تحتاج إلى تثبيت) |
| النموذج الافتراضي في onboarding | deepseek/deepseek-v4-pro |
خبر سيئ يجب معرفته أولًا: deepseek-chat و deepseek-reasoner تقاعدا في 2026-07-24، ولم تعد المعرفات القديمة متاحة. ما زالت الكثير من الدروس القديمة على الإنترنت تستخدمها — يستخدم هذا الدرس معرفات سلسلة V4 القائمة حاليًا طوال الوقت، وترحيل الإعدادات القديمة موضّح في قسم التنبيهات من العثرات. يستند هذا الدرس إلى الإصدار v2026.10.9.
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- تثبيت إضافة DeepSeek الرسمية
@openclaw/deepseek-provider، وإعدادDEEPSEEK_API_KEYفي OpenClaw — اختر أيًا من ثلاث طرق: onboarding أو ملف الإعداد أو السكربت غير التفاعلي - التمييز بين معرفات أربعة نماذج قائمة حاليًا من سلسلة V4، ومعرفة متى يجب تغيير
deepseek-v4-proالافتراضي في onboarding - ترحيل الإعدادات القديمة التي ما زالت تستخدم
deepseek-chat/deepseek-reasonerإلى المعرفات الجديدة - استخدام
/thinkللتحكم في قوة استدلال DeepSeek؛ ولا حاجة إلى/newعند تبديل provider في منتصف محادثة متعددة الأدوار مع استدعاء الأدوات - جعل الإضافة نفسها توفر
web_searchلأي نموذج، دون شراء خدمة بحث منفصلة
🎒 التحضيرات قبل البدء
- إتمام نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج: الإلمام بالخطوات الثلاث «تثبيت الإضافة ← إعداد بيانات الاعتماد ← اختيار النموذج» وقواعد مرجع
provider/model - OpenClaw مثبت وGateway يعمل:
openclaw gateway statusيعطي مخرجات (تسري الإضافة تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن يعمل فتسري عند الإقلاع التالي) - القدرة على الوصول إلى منصة DeepSeek المفتوحة: الخطوة التالية هي التسجيل في platform.deepseek.com وإنشاء مفتاح API
- في حال النشر على خادم / كعملية خلفية، اعرف مكان
~/.openclaw/.env— فالمفتاح سيستقر هناك في النهاية
اتبع خطواتي
الخطوة 1: التسجيل في DeepSeek وإنشاء مفتاح API
لماذا: تُحتسب نماذج DeepSeek عبر واجهة API الرسمية بالدفع، وOpenClaw مسؤول فقط عن الاستدعاء — يجب الحصول على المفتاح أولًا من منصة DeepSeek.
- افتح
https://platform.deepseek.comفي المتصفح، وسجّل / سجّل الدخول - انتقل إلى صفحة API Keys:
https://platform.deepseek.com/api_keys - أنشئ مفتاحًا جديدًا، وانسخه واحفظه
ما يجب أن تراه: مفتاح API قابل للنسخ، على الشكل sk-... كما في مثال الإعداد الرسمي. إنه بيانات الاعتماد الوحيدة التي يستخدمها OpenClaw للوصول إلى DeepSeek API، والخطوة التالية كلها مخصصة لإعداده.
💡 المفتاح هو بيانات الاعتماد الوحيدة على جانب DeepSeek
تُستخدم نفس المفتاح للمحادثة والصور والبحث (web_search يمر عبره أيضًا، انظر قسم المتقدم). بعد الإنشاء لا تتعجل في إغلاق الصفحة، الصقه أولًا في مكان آمن.
الخطوة 2: OpenClaw الاندماج مع DeepSeek — ثبّت الإضافة أولًا ثم أعد DEEPSEEK_API_KEY
لماذا: DeepSeek في OpenClaw هوإضافة رسمية خارجية (على عكس MiniMax المدمج)، لذا هناك خطوة «تثبيت» إضافية مقارنة بالإضافات المدمجة؛ وبعد التثبيت تأتي إعدادات بيانات الاعتماد.
ثبّت الإضافة أولًا (الخطوة الأولى المشتركة بين الطرق الثلاث):
openclaw plugins install @openclaw/deepseek-providerما يجب أن تراه: نجح التثبيت. يسري تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن Gateway يعمل فيسري عند الإقلاع التالي.
ثم أعد المفتاح، اختر مسارًا واحدًا من ثلاثة:
الطريقة A (موصى بها): المعالج الإرشادي onboarding
openclaw onboard --auth-choice deepseek-api-keyلماذا يُوصى بها: أمر واحد يكمل «إعداد بيانات الاعتماد + اختيار النموذج» — يطلب منك لصق مفتاح API، وبعد نجاح التحقق يضبط deepseek/deepseek-v4-pro تلقائيًا كنموذج افتراضي.
ما يجب أن تراه: يطلب أولًا إدخال مفتاح API، وبعد نجاح التحقق من الاتصال يحفظ بيانات الاعتماد ويصبح النموذج الافتراضي deepseek/deepseek-v4-pro.
طمأنتان (مذكورتان صراحةً في الوثائق الرسمية):
- onboarding يحتفظ بإدخالات النماذج الموجودة لديك — إعادة التشغيل لن تحذف إعدادات الموفرين الآخرين
- في وضع
models.mode: "replace"تتم الكتابة إلى الدليل المدمج في الوقت نفسه (لأن هذا الوضع يتخطى الـ discovery)
الطريقة B: تعديل ملف الإعدادات يدويًا
تفضّل أن يكون كل شيء تحت سيطرتك؟ مثال الإعدادات الرسمي (كما هو):
{
env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
agents: {
defaults: {
model: { primary: "deepseek/deepseek-v4-pro" },
},
},
}موضعان، لكل منهما مسؤولية واحدة: env.vars.DEEPSEEK_API_KEY للمفتاح، وagents.defaults.model.primary للنموذج الافتراضي.
الطريقة C: سكربت غير تفاعلي (خوادم / أتمتة)
عند التثبيت عبر سكربت، مرّر جميع المعاملات دفعة واحدة (كما هي، يجب أن يكون $DEEPSEEK_API_KEY مضبوطًا مسبقًا في بيئة السكربت):
openclaw onboard --non-interactive \
--mode local \
--auth-choice deepseek-api-key \
--deepseek-api-key "$DEEPSEEK_API_KEY" \
--skip-health \
--accept-risk⚠️ هل يعمل Gateway كـ daemon؟ لا تضع المفتاح في الـ shell التفاعلي
عندما يعمل Gateway كخدمة launchd / systemd، لا يرى متغيرات البيئة التي صدّرتها بـ export في طرفيتك. اكتب DEEPSEEK_API_KEY في ~/.openclaw/.env، أو زوّد ذلك العملية عبر env.shellEnv في الإعدادات.
- في نظرة عامة على بيانات الاعتماد في
openclaw models status، يمكنك في سطر deepseek رؤية مصدرDEEPSEEK_API_KEY
الخطوة 3: اختيار نموذج من سلسلة V4 والتحقق
لماذا: يختار onboarding افتراضيًا deepseek-v4-pro، لكن سلسلة V4 لديها حاليًا أربعة معرّفات بوظائف مختلفة؛ ألقِ نظرة على الدليل، وغيّر الافتراضي حسب الحاجة، ثم أرسل رسالة للتحقق من السلسلة كاملة.
أولًا، انظر إلى الدليل الحالي:
openclaw models list --provider deepseek # Gateway 在运行时
openclaw models list --all --provider deepseek # 不启动 Gateway 也能看静态目录ينبغي أن ترى: أربعة مراجع نماذج — هذا هو كامل الدليل المدمج لـ DeepSeek في OpenClaw:
| مرجع النموذج | الاسم | المدخلات | السياق | أقصى مخرجات | التموضع |
|---|---|---|---|---|---|
deepseek/deepseek-flash | DeepSeek V4.1 Flash | نص، صور | 1,000,000 | 384,000 | نموذج Flash الرئيسي |
deepseek/deepseek-v4-flash | DeepSeek V4 Flash | نص | 1,000,000 | 384,000 | V4 سريع، يدعم thinking |
deepseek/deepseek-v4-pro | DeepSeek V4 Pro | نص | 1,000,000 | 384,000 | افتراضي onboarding |
deepseek/deepseek-v4-flash-vision-exp | DeepSeek V4 Flash Vision (تجريبي) | نص، صور | 1,000,000 | 384,000 | فهم الصور التجريبي |
كيف تختار، في ثلاث جمل:
| حاجتك | اختر هذا | الأساس |
|---|---|---|
| لا أعرف ماذا أختار / مهام ثقيلة | deepseek/deepseek-v4-pro | افتراضي onboarding هو |
| تريد إرسال صور (PNG / JPEG / GIF / WebP) | deepseek/deepseek-flash | نموذج الصور الرئيسي في الدليل؛ والاختيار القديم deepseek-v4-flash-vision-exp يحتفظ أيضًا بدعم الصور |
| تريد السرعة | deepseek/deepseek-v4-flash | التموضع الرسمي «Fast V4» |
تغيير النموذج الافتراضي (مثلًا إلى Flash):
openclaw models set deepseek/deepseek-flashيمكن أيضًا التبديل مؤقتًا داخل الدردشة: /model deepseek/deepseek-v4-pro يؤثر على الجلسة الحالية فقط، راجع عائلة الأوامر في دليل سريع لأوامر الدردشة.
التحقق أخيرًا — أرسل رسالة اختبار:
openclaw agent --agent main --model deepseek/deepseek-v4-pro --message "用一句话介绍你自己"(يتطلب openclaw agent محدد جلسة واحدًا على الأقل، و--agent main يشير إلى الـ agent الافتراضي — الموجود افتراضيًا في أي تثبيت أكمل onboarding وهو main؛ أو افتح openclaw dashboard واجهة Control وأرسل مباشرة من صندوق الدردشة.)
ينبغي أن ترى: ردًا طبيعيًا من النموذج، دون أخطاء حول بيانات اعتماد مفقودة أو نموذج غير موجود. إلى هنا، اكتمل توصيل OpenClaw بـ DeepSeek.
لنوضّح الأسعار سريعًا (حتى لا تفاجئك الفاتورة):
التكلفة في دليل OpenClaw هيتقديرية: صف
deepseek/deepseek-flashمحسوب بأسعار ذروة DeepSeek — لكل مليون token إدخال $0.30، وإخراج $1.20، وإدخال مخزّن مؤقتًا $0.006؛ وأسعار خارج الذروة المعلنة رسميًا منخفضة إلى النصفلا يزال
deepseek-v4-flashوdeepseek-v4-flash-vision-expمقبولين لدى DeepSeek، لكن يتم توجيههما إلى V4.1 Flash والفوترة بأسعار Flash الحاليةلم تُنشر وثائق أسعار
deepseek-v4-pro؛ ويمكن لـ DeepSeek تعديل الأسعار في أي وقت — الفوترة تعتمد على صفحة Models & Pricing الرسميةوصل رد على رسالة الاختبار من DeepSeek
نقاط التحقق ✅
- تم تنفيذ
openclaw plugins install @openclaw/deepseek-provider، والإضافة موجودة في القائمة - يمكن رؤية
DEEPSEEK_API_KEYالخاص بـ deepseek في نظرة عامة على بيانات الاعتماد فيopenclaw models status - يسرد
openclaw models list --provider deepseekأربعة نماذج حالية من سلسلة V4 - وصل رد من DeepSeek بعد إرسال رسالة الاختبار
- لا توجد في الإعدادات معرّفات متقاعدة مثل
deepseek-chat/deepseek-reasoner
تنبيهات للمزالق
❌ ما زلت تستخدم deepseek-chat / deepseek-reasoner (متقاعدان)
السبب: تقاعد DeepSeek هذين المعرّفين للنماذج بتاريخ 2026/7/24 الساعة 15:59 UTC، ولم يعد يمكن الوصول إليهما. هذان الاسمان منتشران في الدروس والإعدادات القديمة، ونسخهما كما هو سيؤدي حتمًا إلى أخطاء.
# ❌ متقاعد، لم يعد يمكن الوصول إليه
deepseek/deepseek-chat
deepseek/deepseek-reasoner
# ✅ وجهتا الترحيل اللتان حددتهما الجهة الرسمية (كلتاهما تدعمان thinking)
deepseek/deepseek-v4-flash
deepseek/deepseek-v4-proالطريقة الصحيحة: استبدل المعرّفات القديمة في الإعدادات والجلسات بأحد المعرّفين الجديدين أعلاه؛ وإذا لم تكن متأكدًا فنفّذ openclaw models list --provider deepseek وانسخ من الدليل الحالي.
❌ بعد تثبيت Gateway كـ daemon، يبدو أن المفتاح المُصدَّر بـ export «لا يعمل»
السبب: خدمات launchd / systemd لا ترى متغيرات البيئة في الـ shell التفاعلي الخاص بك — كل وثائق الموفرين تشدد على هذه النقطة تحديدًا.
الطريقة الصحيحة: اكتب DEEPSEEK_API_KEY في ~/.openclaw/.env، أو قدّمه عبر env.shellEnv في الإعدادات؛ بعد تغيير المفتاح أعد تشغيل خدمة Gateway.
❌ أردت أن يرى النموذج الصور فاخترت v4-pro / v4-flash
السبب: deepseek-v4-pro و deepseek-v4-flash في الدليل يقبلان النص فقط. لإدخال الصور استخدم deepseek/deepseek-flash — فهو يقبل PNG و JPEG و GIF و WebP، عبر نفس الواجهة البرمجية ونفس المفتاح؛ كما تحتفظ مجموعة deepseek-v4-flash-vision-exp القديمة بدعم الصور.
❌ اعتبار الأسعار في دليل OpenClaw فاتورة
السبب: التكلفة المحلية في OpenClaw قيمة تقديرية، ويمكن لـ DeepSeek تعديل الأسعار في أي وقت؛ سعر خارج أوقات الذروة يساوي نصف سعر الذروة، لذا فتقلب الفاتورة أمر طبيعي تمامًا.
الطريقة الصحيحة: تعتمد الفوترة دائمًا على صفحة Models & Pricing الرسمية من DeepSeek؛ وللتحكم في التكلفة، انتبه لفرق الذروة / خارج الذروة، وللسعر المنخفض للمدخلات المخبأة ($0.006 / لكل مليون token).
🔧 قدرات حصرية لـ DeepSeek (اختيارية)
بعد تثبيت الإضافة، تأتي ثلاث قدرات حصرية لـ DeepSeek تلقائيًا معها.
thinking التحكم في
تدعم سلسلة Flash و V4 كلاهما تحكم DeepSeek عبر thinking:
/think xhigh # يُحوَّل إلى أقصى reasoning_effort لدى DeepSeek "max"
/think max # يُحوَّل كذلك إلى "max"عند تعطيل thinking (بما في ذلك درجة None في الواجهة)، يرسل OpenClaw قيمة thinking: { type: "disabled" }، ويزيل reasoning_content من السجل المُرسَل، ليبقى الحوار على المسار غير المفكِّر.
استدعاء الأدوات متعدد الأدوار له شرط خاص بـ DeepSeek — جلسات thinking لدى V4 تتطلب من الطلبات اللاحقة إعادة reasoning_content — والإضافة تعيد ملء هذا الحقل تلقائيًا، لذا يمكن لاستدعاءات الأدوات داخل جلسات thinking أن تستمر بشكل طبيعي؛ وحتى لو انتقلت في المنتصف من provider آخر، فلا حاجة لاستخدام /new.
استعادة أدوات DSML
أحيانًا تُخرج نماذج DeepSeek علامات الأدوات كنص (علامات DSML، بما في ذلك عند التمرير عبر provider متوافق مع OpenAI آخر مثل OpenRouter). يعيد OpenClaw الكتل الصالحة منها calls / tool_calls / tool_call / function_calls إلى استدعاءات أدوات حقيقية، بدلًا من أن ترى كتلة من نص العلامات في المحادثة.
ثلاثة حدود:
- استدعاء الأدوات الأصلي له الأولوية — عند وجود كليهما في نفس الاستجابة، لا تُنفَّذ الاستدعاءات المكررة المستعادة
- الكتل المشوهة أو غير المكتملة تُخفى فقط ولا تُنفَّذ
- الاستدعاءات المستعادة تخضع كالمعتاد لضوابط صلاحيات الأدوات القائمة
web_search: إضافة واحدة باستخدامان
إضافة deepseek نفسها يمكنها أيضًا توفير web_search لأي** نموذج** — مباشرة عبر محرك بحث DeepSeek، وليس عبر إكمال المحادثة. اختر DeepSeek في Settings → Search، أو:
openclaw configure --section webطريقة الكتابة في ملف الإعدادات (كما هي؛ يمكن حذف المفتاح — أولوية بيانات الاعتماد: مفتاح بحث الإضافة → متغير البيئة DEEPSEEK_API_KEY → مفتاح provider النموذج):
{
tools: {
web: {
search: { provider: "deepseek" },
},
},
plugins: {
entries: {
deepseek: {
config: {
webSearch: {
apiKey: "YOUR_DEEPSEEK_API_KEY",
},
},
},
},
},
}الفوترة والحدود: 5 طلبات / ثانية لكل حساب؛ $0.75 / 1000 بحث ناجح وغير فارغ — النتائج الفارغة والطلبات الفاشلة لا تُحتسب في الفوترة. يستخدم البحث دائمًا https://api.deepseek.com/v1/tools/search؛ وحتى لو ضبطت baseUrl وسيطًا للمحادثة، فلن يُوجَّه البحث إلى الوكيل.
الخطوة التالية
OpenClaw بهذا تكتمل إعدادات DeepSeek. صفحة النماذج المحلية الخاصة لم تفتتح بعد إلا للتو:
- الدرس التالي توصيل Qwen من Tongyi Qianwen: ثلاث باقات DashScope: كيف تختار بين نقاط النهاية الثلاث لـ DashScope: Coding / Standard / Token Plan، وكيف تضبط
QWEN_API_KEY - صفحات النماذج المحلية الأخرى (GLM و Kimi و MiniMax و Doubao و Hunyuan / Qianfan) تُفتح من جدول الدروس في نظرة عامة على توصيل النماذج
- انتهيت من ضبط النماذج؟ الاستخدام اليومي يبدأ من الاستخدام اليومي: التعامل بكفاءة مع Claw الخاص بك — واجهة Control UI وأوامر المحادثة ونظام الذاكرة كلها في ذلك الفصل