---
read_when:
- میخواهید OpenClaw را روی antirez/ds4 اجرا کنید
- شما یک بکاند محلی DeepSeek V4 Flash با فراخوانی ابزار میخواهید
- برای ds4-server به پیکربندی OpenClaw نیاز دارید
summary: OpenClaw را از طریق ds4، یک سرور محلی سازگار با OpenAI برای DeepSeek V4 Flash، اجرا کنید
title: ds4
x-i18n:
generated_at: "2026-06-27T18:39:41Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: a9922421d39f5d2d29dfa62de9fc3de7131dfa96445d0646cd02ad766a125544
source_path: providers/ds4.md
workflow: 16
---
[ds4](https://github.com/antirez/ds4) مدل DeepSeek V4 Flash را از یک بکاند محلی
Metal با API سازگار با OpenAI در مسیر `/v1` ارائه میکند. OpenClaw از طریق
خانوادهٔ عمومی providerهای `openai-completions` به ds4 متصل میشود.
ds4 یک provider Plugin همراه OpenClaw نیست. آن را زیر
`models.providers.ds4` پیکربندی کنید، سپس `ds4/deepseek-v4-flash` را انتخاب کنید.
- شناسهٔ provider: `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.
- یک checkout فعال از ds4 همراه با `ds4-server` و فایل GGUF مدل DeepSeek V4 Flash.
- حافظهٔ کافی برای context انتخابی شما. مقدارهای بزرگتر `--ctx` هنگام شروع
سرور حافظهٔ KV بیشتری اختصاص میدهند.
نوبتهای agent در OpenClaw شامل طرحوارههای ابزار و context فضای کار هستند. یک context
بسیار کوچک مانند `--ctx 4096` ممکن است آزمونهای مستقیم curl را بگذراند، اما اجرای کامل
agent را با `500 prompt exceeds context` ناموفق کند. برای آزمونهای smoke مربوط به agent و
ابزار، دستکم از `--ctx 32768` استفاده کنید. فقط زمانی از `--ctx 393216` استفاده کنید که
حافظهٔ کافی دارید و رفتار ds4 Think Max را میخواهید.
## شروع سریع
`` را با مسیر checkout مربوط به ds4 جایگزین کنید.
```bash
/ds4-server \
--model /ds4flash.gguf \
--host 127.0.0.1 \
--port 18000 \
--ctx 32768 \
--tokens 128
```
```bash
curl http://127.0.0.1:18000/v1/models
```
پاسخ باید شامل `deepseek-v4-flash` باشد.
پیکربندی بخش [پیکربندی کامل](#full-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` را به همان ورودی provider اضافه کنید:
```json5
{
models: {
providers: {
ds4: {
baseUrl: "http://127.0.0.1:18000/v1",
apiKey: "ds4-local",
api: "openai-completions",
timeoutSeconds: 300,
localService: {
command: "/ds4-server",
args: [
"--model",
"/ds4flash.gguf",
"--host",
"127.0.0.1",
"--port",
"18000",
"--ctx",
"32768",
"--tokens",
"128",
],
cwd: "",
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` باید یک مسیر اجرایی مطلق باشد. جستوجوی shell و گسترش `~`
استفاده نمیشوند. برای همهٔ فیلدهای `localService`، [سرویسهای مدل محلی](/fa/gateway/local-model-services) را ببینید.
## Think Max
ds4 فقط زمانی Think Max را اعمال میکند که هر دو شرط برقرار باشند:
- `ds4-server` با `--ctx 393216` یا بالاتر شروع شود.
- درخواست از `reasoning_effort: "max"` یا فیلد effort معادل در ds4 استفاده کند.
اگر آن context بزرگ را اجرا میکنید، هم پرچمهای سرور و هم فرادادهٔ مدل 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 شروع کنید:
```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
```
برای یک smoke کامل مربوط به agent و فراخوانی ابزار، از context دستکم 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