Providers
ds4
ds4 透過本機 Metal 後端提供 DeepSeek V4 Flash，並具備與 OpenAI 相容的 /v1 API。OpenClaw 透過通用的 openai-completions 提供者系列連線至 ds4。
ds4 並非 OpenClaw 內建的提供者外掛。請在 models.providers.ds4 下進行設定，然後選擇 ds4/deepseek-v4-flash。
| 屬性 | 值 |
|---|---|
| 提供者 ID | ds4 |
| 外掛 | 無（僅透過設定） |
| API | 與 OpenAI 相容的 Chat Completions（openai-completions） |
| 基礎 URL | http://127.0.0.1:18000/v1（建議） |
| 模型 ID | deepseek-v4-flash |
| 工具呼叫 | OpenAI 風格的 tools / tool_calls |
| 推理 | DeepSeek 風格的 thinking 與 reasoning_effort |
需求
- 支援 Metal 的 macOS。
- 可正常運作的 ds4 原始碼簽出，其中包含
ds4-server與 DeepSeek V4 Flash GGUF 檔案。 - 足以容納所選上下文的記憶體；較大的
--ctx值會在伺服器啟動時配置更多 KV 記憶體。
快速開始
啟動 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 保持一致。除非刻意要讓 OpenClaw 請求的輸出少於伺服器預設值，否則請使 maxTokens 與 --tokens 保持一致。
隨選啟動
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 必須是可執行檔的絕對路徑。不會使用 Shell 路徑查找或 ~ 展開。如需瞭解所有 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"], },}測試
略過 OpenClaw 的直接 HTTP 檢查：
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為ds4executionTrace.winnerModel為deepseek-v4-flashtoolSummary.calls至少為1finalAssistantVisibleText以tool-ok開頭
疑難排解
curl /v1/models 無法連線
ds4 尚未執行，或未繫結至 baseUrl 中的主機／連接埠。請啟動 ds4-server，然後重試：
curl http://127.0.0.1:18000/v1/models500 prompt exceeds context
設定的 --ctx 對 OpenClaw 回合而言太小。請提高 ds4-server --ctx，然後更新 models.providers.ds4.models[].contextWindow 以與其相符。包含工具的完整代理程式回合所需的上下文遠多於直接傳送單一訊息的 curl 請求。
Think Max 未啟用
只有當 --ctx 至少為 393216，且請求指定 reasoning_effort: "max" 時，ds4 才會使用 Think Max。較小的上下文會回退至高強度推理。
第一次請求速度緩慢
ds4 需要經歷 Metal 冷啟駐留與模型暖機階段。當 OpenClaw 隨選啟動伺服器時，請設定 localService.readyTimeoutMs: 300000。
