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 |
| فراخوانی ابزارها | به سبک OpenAI، tools / tool_calls |
| استدلال | به سبک DeepSeek، thinking و reasoning_effort |
الزامات
- macOS با پشتیبانی از Metal.
- یک checkout عملیاتی از ds4 بههمراه
ds4-serverو فایل GGUF مدل DeepSeek V4 Flash. - حافظه کافی برای بافت انتخابی؛ مقادیر بزرگتر
--ctxهنگام راهاندازی سرور حافظه KV بیشتری تخصیص میدهند.
شروع سریع
راهاندازی ds4-server
<DS4_DIR> را با مسیر checkout مدل 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: پرامپت از بافت فراتر میرود
--ctx پیکربندیشده برای نوبت OpenClaw بیش از حد کوچک است.
ds4-server --ctx را افزایش دهید، سپس models.providers.ds4.models[].contextWindow را
مطابق آن بهروزرسانی کنید. نوبتهای کامل عامل همراه با ابزارها نسبت به یک
درخواست مستقیم curl با یک پیام، به بافت بسیار بیشتری نیاز دارند.
Think Max فعال نمیشود
ds4 تنها زمانی از Think Max استفاده میکند که --ctx دستکم 393216 باشد و درخواست
reasoning_effort: "max" را بخواهد. بافتهای کوچکتر به استدلال
بالا بازمیگردند.
نخستین درخواست کند است
ds4 یک مرحله استقرار سرد در Metal و گرمسازی مدل دارد. وقتی OpenClaw سرور را
برحسب تقاضا راهاندازی میکند، localService.readyTimeoutMs: 300000 را تنظیم کنید.
