Skip to content

الاندماج مع DeepSeek: دليل عملي لإعداد نماذج سلسلة V4 ​

OpenClaw الاندماج مع DeepSeek هو المحطة الأولى في صفحة النماذج المحلية، وهو أيضًا الأسهل: واجهة API متوافقة مع OpenAI، ومتغير بيئة واحد، وأمر onboarding واحد. الخطوات الثلاث من الدرس السابق «تثبيت الإضافة ← إعداد بيانات الاعتماد ← اختيار النموذج» سنمر بها كاملة في هذا الدرس، وتستغرق حوالي 8 دقائق (دون احتساب تسجيل حساب DeepSeek).

إليك أولًا جدولًا سريعًا تنطلق منه كل إعدادات هذا الدرس:

الخاصيةالقيمة
معرّف providerdeepseek
متغير بيئة المصادقةDEEPSEEK_API_KEY
شكل واجهة APIمتوافق مع OpenAI
Base URLhttps://api.deepseek.com
الإضافة الرسمية@openclaw/deepseek-provider (إضافة خارجية، تحتاج إلى تثبيت)
النموذج الافتراضي في onboardingdeepseek/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.

  1. افتح https://platform.deepseek.com في المتصفح، وسجّل / سجّل الدخول
  2. انتقل إلى صفحة API Keys: https://platform.deepseek.com/api_keys
  3. أنشئ مفتاحًا جديدًا، وانسخه واحفظه

ما يجب أن تراه: مفتاح API قابل للنسخ، على الشكل sk-... كما في مثال الإعداد الرسمي. إنه بيانات الاعتماد الوحيدة التي يستخدمها OpenClaw للوصول إلى DeepSeek API، والخطوة التالية كلها مخصصة لإعداده.

💡 المفتاح هو بيانات الاعتماد الوحيدة على جانب DeepSeek

تُستخدم نفس المفتاح للمحادثة والصور والبحث (web_search يمر عبره أيضًا، انظر قسم المتقدم). بعد الإنشاء لا تتعجل في إغلاق الصفحة، الصقه أولًا في مكان آمن.

الخطوة 2: OpenClaw الاندماج مع DeepSeek — ثبّت الإضافة أولًا ثم أعد DEEPSEEK_API_KEY ​

لماذا: DeepSeek في OpenClaw هوإضافة رسمية خارجية (على عكس MiniMax المدمج)، لذا هناك خطوة «تثبيت» إضافية مقارنة بالإضافات المدمجة؛ وبعد التثبيت تأتي إعدادات بيانات الاعتماد.

ثبّت الإضافة أولًا (الخطوة الأولى المشتركة بين الطرق الثلاث):

bash
openclaw plugins install @openclaw/deepseek-provider

ما يجب أن تراه: نجح التثبيت. يسري تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن Gateway يعمل فيسري عند الإقلاع التالي.

ثم أعد المفتاح، اختر مسارًا واحدًا من ثلاثة:

الطريقة A (موصى بها): المعالج الإرشادي onboarding ​

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

لماذا يُوصى بها: أمر واحد يكمل «إعداد بيانات الاعتماد + اختيار النموذج» — يطلب منك لصق مفتاح API، وبعد نجاح التحقق يضبط deepseek/deepseek-v4-pro تلقائيًا كنموذج افتراضي.

ما يجب أن تراه: يطلب أولًا إدخال مفتاح API، وبعد نجاح التحقق من الاتصال يحفظ بيانات الاعتماد ويصبح النموذج الافتراضي deepseek/deepseek-v4-pro.

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

  • onboarding يحتفظ بإدخالات النماذج الموجودة لديك — إعادة التشغيل لن تحذف إعدادات الموفرين الآخرين
  • في وضع models.mode: "replace" تتم الكتابة إلى الدليل المدمج في الوقت نفسه (لأن هذا الوضع يتخطى الـ discovery)

الطريقة B: تعديل ملف الإعدادات يدويًا ​

تفضّل أن يكون كل شيء تحت سيطرتك؟ مثال الإعدادات الرسمي (كما هو):

json5
{
  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 مضبوطًا مسبقًا في بيئة السكربت):

bash
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 لديها حاليًا أربعة معرّفات بوظائف مختلفة؛ ألقِ نظرة على الدليل، وغيّر الافتراضي حسب الحاجة، ثم أرسل رسالة للتحقق من السلسلة كاملة.

أولًا، انظر إلى الدليل الحالي:

bash
openclaw models list --provider deepseek        # Gateway 在运行时
openclaw models list --all --provider deepseek  # 不启动 Gateway 也能看静态目录

ينبغي أن ترى: أربعة مراجع نماذج — هذا هو كامل الدليل المدمج لـ DeepSeek في OpenClaw:

مرجع النموذجالاسمالمدخلاتالسياقأقصى مخرجاتالتموضع
deepseek/deepseek-flashDeepSeek V4.1 Flashنص، صور1,000,000384,000نموذج Flash الرئيسي
deepseek/deepseek-v4-flashDeepSeek V4 Flashنص1,000,000384,000V4 سريع، يدعم thinking
deepseek/deepseek-v4-proDeepSeek V4 Proنص1,000,000384,000افتراضي onboarding
deepseek/deepseek-v4-flash-vision-expDeepSeek V4 Flash Vision (تجريبي)نص، صور1,000,000384,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):

bash
openclaw models set deepseek/deepseek-flash

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

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

bash
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، ولم يعد يمكن الوصول إليهما. هذان الاسمان منتشران في الدروس والإعدادات القديمة، ونسخهما كما هو سيؤدي حتمًا إلى أخطاء.

text
# ❌ متقاعد، لم يعد يمكن الوصول إليه
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:

text
/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، أو:

bash
openclaw configure --section web

طريقة الكتابة في ملف الإعدادات (كما هي؛ يمكن حذف المفتاح — أولوية بيانات الاعتماد: مفتاح بحث الإضافة → متغير البيئة DEEPSEEK_API_KEY → مفتاح provider النموذج):

json5
{
  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. صفحة النماذج المحلية الخاصة لم تفتتح بعد إلا للتو:

دروس ذات صلة ​

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.