Providers
ds4
ds4 は、ローカルの Metal バックエンドから、OpenAI 互換の /v1 API を使用して DeepSeek V4 Flash を提供します。OpenClaw は汎用の openai-completions プロバイダーファミリーを介して ds4 に接続します。
ds4 は OpenClaw に同梱されるプロバイダー Plugin ではありません。models.providers.ds4 で設定し、ds4/deepseek-v4-flash を選択してください。
| プロパティ | 値 |
|---|---|
| プロバイダー ID | ds4 |
| Plugin | なし（設定のみ） |
| 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-serverと DeepSeek V4 Flash の GGUF ファイルを含む、動作する ds4 のチェックアウト。- 選択するコンテキストに十分なメモリ。
--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 128OpenAI 互換エンドポイントを確認する
curl http://127.0.0.1:18000/v1/modelsレスポンスに deepseek-v4-flash が含まれていることを確認してください。
OpenClaw のプロバイダー設定を追加する
完全な設定の設定を追加し、1 回限りのモデルチェックを実行します。
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 は実行可能ファイルの絶対パスである必要があります。シェルによる検索と ~ の展開は使用されません。すべての 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" \ --json32768 以上のコンテキストを使用した、完全なエージェントとツール呼び出しのスモークテスト：
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が1以上finalAssistantVisibleTextが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 が有効にならない
ds4 が Think Max を使用するのは、--ctx が 393216 以上で、かつリクエストが reasoning_effort: "max" を要求する場合のみです。より小さいコンテキストでは、高い推論強度にフォールバックします。
最初のリクエストが遅い
ds4 には、Metal への初回常駐とモデルのウォームアップ処理があります。OpenClaw がオンデマンドでサーバーを起動する場合は、localService.readyTimeoutMs: 300000 を設定してください。
