OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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 إضافية عند بدء تشغيل الخادم.

البدء السريع

  • تشغيل ds4-server

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

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

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

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

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

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

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

    bash
    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.

    json5
    {  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 إلى إدخال المزوّد نفسه:

    json5
    {  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:

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

    الاختبار

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

    bash
    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 (كما في فحص البدء السريع):

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

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

    bash
    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، ثم أعد المحاولة:

    bash
    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 الأصلي وعناصر التحكم في التفكير.
    Was this useful?
    On this page

    On this page