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 با API سازگار با OpenAI در مسیر /v1 ارائه می‌کند. OpenClaw از طریق خانوادهٔ عمومی ارائه‌دهندگان openai-completions به ds4 متصل می‌شود.

ds4 یک Plugin ارائه‌دهندهٔ همراه OpenClaw نیست. آن را در models.providers.ds4 پیکربندی کنید، سپس ds4/deepseek-v4-flash را انتخاب کنید.

ویژگی مقدار
شناسهٔ ارائه‌دهنده ds4
Plugin ندارد (فقط پیکربندی)
API Chat Completions سازگار با OpenAI (openai-completions)
نشانی پایه 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 بیشتری تخصیص می‌دهند.

شروع سریع

  • Start 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

  • Verify the OpenAI-compatible endpoint

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

    پاسخ باید شامل deepseek-v4-flash باشد.

  • Add the OpenClaw provider config

    پیکربندی بخش پیکربندی کامل را اضافه کنید، سپس یک بررسی یک‌بارهٔ مدل اجرا کنید:

    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 cannot connect

    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 does not activate

    ds4 فقط زمانی از Think Max استفاده می‌کند که --ctx دست‌کم 393216 باشد و درخواست reasoning_effort: "max" را بخواهد. زمینه‌های کوچک‌تر به استدلال سطح بالا بازمی‌گردند.

    The first request is slow

    ds4 دارای مرحلهٔ استقرار سرد در Metal و گرم‌سازی مدل است. هنگامی که OpenClaw سرور را هنگام نیاز راه‌اندازی می‌کند، localService.readyTimeoutMs: 300000 را تنظیم کنید.

    مرتبط

    Local model services

    سرورهای مدل محلی را پیش از درخواست‌های مدل و هنگام نیاز راه‌اندازی کنید.
    Local models

    بک‌اندهای مدل محلی را انتخاب و مدیریت کنید.
    Model providers

    ارجاع‌های ارائه‌دهنده، احراز هویت و جایگزینی هنگام خرابی را پیکربندی کنید.
    DeepSeek

    رفتار بومی ارائه‌دهندهٔ DeepSeek و کنترل‌های تفکر.
    Was this useful?
    On this page

    On this page