ds4

ds4 يقدّم DeepSeek V4 Flash من واجهة Metal خلفية محلية عبر واجهة /v1 متوافقة مع OpenAI. يتصل OpenClaw بـ ds4 من خلال عائلة المزوّدات العامة openai-completions. لا يُعد ds4 Plugin مزوّد مضمّنًا في OpenClaw. اضبطه ضمن models.providers.ds4، ثم اختر ds4/deepseek-v4-flash.

الخاصية	القيمة
معرّف المزوّد	`ds4`
Plugin	لا يوجد (إعداد فقط)
API	إكمالات المحادثة المتوافقة مع OpenAI (`openai-completions`)
عنوان URL الأساسي	`http://127.0.0.1:18000/v1` (مقترح)
معرّف النموذج	`deepseek-v4-flash`
استدعاءات الأدوات	`tools` / `tool_calls` بأسلوب OpenAI
الاستدلال	`thinking` و`reasoning_effort` بأسلوب DeepSeek

المتطلبات

نظام macOS يدعم Metal.
نسخة مستنسخة عاملة من ds4 تتضمن ds4-server وملف GGUF الخاص بـ DeepSeek V4 Flash.
ذاكرة كافية للسياق الذي تختاره؛ إذ تخصّص قيم --ctx الأكبر ذاكرة KV إضافية عند بدء تشغيل الخادم.

تتضمن دورات وكيل OpenClaw مخططات الأدوات وسياق مساحة العمل. قد يجتاز سياق صغير مثل --ctx 4096 اختبارات curl المباشرة، لكنه يفشل في تشغيلات الوكيل الكاملة مع 500 prompt exceeds context. استخدم --ctx 32768 على الأقل لاختبارات التحقق السريعة للوكيل والأدوات. لا تستخدم --ctx 393216 إلا عند توفر ذاكرة كافية ولتفعيل Think Max في ds4.

البدء السريع

تشغيل ds4-server

استبدل <DS4_DIR> بمسار النسخة المستنسخة من ds4.

<DS4_DIR>/ds4-server \
  --model <DS4_DIR>/ds4flash.gguf \
  --host 127.0.0.1 \
  --port 18000 \
  --ctx 32768 \
  --tokens 128

التحقق من نقطة النهاية المتوافقة مع OpenAI

curl http://127.0.0.1:18000/v1/models

يجب أن تتضمن الاستجابة deepseek-v4-flash.

إضافة إعداد مزوّد OpenClaw

أضف الإعداد من الإعداد الكامل، ثم شغّل فحصًا للنموذج لمرة واحدة:

openclaw infer model run \
  --local \
  --model ds4/deepseek-v4-flash \
  --thinking off \
  --prompt "Reply with exactly: openclaw-ds4-ok" \
  --json

الإعداد الكامل

استخدم هذا الإعداد عندما يكون ds4 قيد التشغيل بالفعل على 127.0.0.1:18000.

{
  agents: {
    defaults: {
      model: { primary: "ds4/deepseek-v4-flash" },
      models: {
        "ds4/deepseek-v4-flash": {
          alias: "DS4 local",
        },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      ds4: {
        baseUrl: "http://127.0.0.1:18000/v1",
        apiKey: "ds4-local",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "deepseek-v4-flash",
            name: "DeepSeek V4 Flash (ds4)",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 32768,
            maxTokens: 128,
            compat: {
              supportsUsageInStreaming: true,
              supportsReasoningEffort: true,
              maxTokensField: "max_tokens",
              supportsStrictMode: false,
              thinkingFormat: "deepseek",
              supportedReasoningEfforts: ["low", "medium", "high", "xhigh"],
            },
          },
        ],
      },
    },
  },
}

حافظ على توافق contextWindow مع ds4-server --ctx. وحافظ على توافق maxTokens مع --tokens ما لم تكن تريد عمدًا أن يطلب OpenClaw مخرجات أقل من القيمة الافتراضية للخادم.

التشغيل عند الطلب

يمكن لـ OpenClaw تشغيل ds4 فقط عند اختيار نموذج ds4/.... أضف localService إلى إدخال المزوّد نفسه:

{
  models: {
    providers: {
      ds4: {
        baseUrl: "http://127.0.0.1:18000/v1",
        apiKey: "ds4-local",
        api: "openai-completions",
        timeoutSeconds: 300,
        localService: {
          command: "<DS4_DIR>/ds4-server",
          args: [
            "--model",
            "<DS4_DIR>/ds4flash.gguf",
            "--host",
            "127.0.0.1",
            "--port",
            "18000",
            "--ctx",
            "32768",
            "--tokens",
            "128",
          ],
          cwd: "<DS4_DIR>",
          healthUrl: "http://127.0.0.1:18000/v1/models",
          readyTimeoutMs: 300000,
          idleStopMs: 0,
        },
        models: [
          {
            id: "deepseek-v4-flash",
            name: "DeepSeek V4 Flash (ds4)",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 32768,
            maxTokens: 128,
            compat: {
              supportsUsageInStreaming: true,
              supportsReasoningEffort: true,
              maxTokensField: "max_tokens",
              supportsStrictMode: false,
              thinkingFormat: "deepseek",
              supportedReasoningEfforts: ["low", "medium", "high", "xhigh"],
            },
          },
        ],
      },
    },
  },
}

يجب أن تكون قيمة command مسارًا مطلقًا لملف قابل للتنفيذ. لا يُستخدم البحث عبر الصدفة ولا توسيع ~. راجع خدمات النماذج المحلية للاطلاع على جميع حقول localService.

Think Max

يطبّق ds4 ميزة Think Max فقط عند تحقق الشرطين التاليين:

يبدأ ds4-server باستخدام --ctx 393216 أو قيمة أعلى.
يستخدم الطلب reasoning_effort: "max" (أو حقل الجهد المكافئ في ds4).

إذا شغّلت هذا السياق الكبير، فحدّث كلاً من أعلام الخادم والبيانات الوصفية لنموذج OpenClaw:

{
  contextWindow: 393216,
  maxTokens: 384000,
  compat: {
    supportsUsageInStreaming: true,
    supportsReasoningEffort: true,
    maxTokensField: "max_tokens",
    supportsStrictMode: false,
    thinkingFormat: "deepseek",
    supportedReasoningEfforts: ["low", "medium", "high", "xhigh", "max"],
  },
}

الاختبار

فحص HTTP مباشر يتجاوز OpenClaw:

curl http://127.0.0.1:18000/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"Reply with exactly: ds4-ok"}],"max_tokens":16,"stream":false,"thinking":{"type":"disabled"}}'

توجيه نموذج OpenClaw (كما في فحص البدء السريع):

openclaw infer model run \
  --local \
  --model ds4/deepseek-v4-flash \
  --thinking off \
  --prompt "Reply with exactly: openclaw-ds4-ok" \
  --json

اختبار تحقق سريع كامل للوكيل واستدعاء الأدوات، بسياق لا يقل عن 32768:

openclaw agent \
  --local \
  --session-id ds4-tool-smoke \
  --model ds4/deepseek-v4-flash \
  --thinking off \
  --message "Use the shell command pwd once, then reply exactly: tool-ok <output>" \
  --json \
  --timeout 240

النتيجة المتوقعة:

تكون قيمة executionTrace.winnerProvider هي ds4
تكون قيمة executionTrace.winnerModel هي deepseek-v4-flash
تكون قيمة toolSummary.calls على الأقل 1
يبدأ finalAssistantVisibleText بـ tool-ok

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

يتعذر على curl /v1/models الاتصال

ds4 ليس قيد التشغيل أو غير مرتبط بالمضيف/المنفذ المحدد في baseUrl. شغّل ds4-server، ثم أعد المحاولة:

curl http://127.0.0.1:18000/v1/models

500 prompt exceeds context

قيمة --ctx المضبوطة أصغر من اللازم لدورة OpenClaw. ارفع قيمة ds4-server --ctx، ثم حدّث models.providers.ds4.models[].contextWindow لتطابقها. تحتاج دورات الوكيل الكاملة التي تتضمن أدوات إلى سياق أكبر بكثير من طلب curl مباشر ذي رسالة واحدة.

عدم تفعيل Think Max

لا يستخدم ds4 ميزة Think Max إلا عندما تكون قيمة --ctx على الأقل 393216 ويطلب الطلب reasoning_effort: "max". تعود السياقات الأصغر إلى الاستدلال العالي.

بطء الطلب الأول

يمر ds4 بمرحلة إقامة أولية باردة في Metal وتهيئة للنموذج. اضبط localService.readyTimeoutMs: 300000 عندما يشغّل OpenClaw الخادم عند الطلب.

ذو صلة

خدمات النماذج المحلية

شغّل خوادم النماذج المحلية عند الطلب قبل طلبات النماذج.

النماذج المحلية

اختر واجهات النماذج الخلفية المحلية وشغّلها.

مزوّدو النماذج

اضبط مراجع المزوّد والمصادقة وتجاوز الفشل.

DeepSeek

سلوك مزوّد DeepSeek الأصلي وعناصر التحكم في التفكير.

Overview

Concepts and configuration

Providers

المتطلبات

البدء السريع

الإعداد الكامل

التشغيل عند الطلب

Think Max

الاختبار

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

ذو صلة

خدمات النماذج المحلية

النماذج المحلية

مزوّدو النماذج

DeepSeek

​المتطلبات

​البدء السريع

​الإعداد الكامل

​التشغيل عند الطلب

​Think Max

​الاختبار

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

​ذو صلة

خدمات النماذج المحلية

النماذج المحلية

مزوّدو النماذج

DeepSeek

المتطلبات

البدء السريع

الإعداد الكامل

التشغيل عند الطلب

Think Max

الاختبار

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

ذو صلة