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 メモリが割り当てられます。
クイックスタート
Start ds4-server
<DS4_DIR> を ds4 のチェックアウトパスに置き換えます。
<DS4_DIR>/ds4-server \ --model <DS4_DIR>/ds4flash.gguf \ --host 127.0.0.1 \ --port 18000 \ --ctx 32768 \ --tokens 128Verify the OpenAI-compatible endpoint
curl http://127.0.0.1:18000/v1/modelsレスポンスに deepseek-v4-flash が含まれている必要があります。
Add the OpenClaw provider config
完全な設定 の設定を追加し、ワンショットのモデルチェックを実行します。
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 effort フィールドを使用している。
その大きなコンテキストを実行する場合は、サーバーフラグと OpenClaw モデルメタデータの両方を更新します。
{ contextWindow: 393216, maxTokens: 384000, compat: { supportsUsageInStreaming: true, supportsReasoningEffort: true, maxTokensField: "max_tokens", supportsStrictMode: false, thinkingFormat: "deepseek", supportedReasoningEfforts: ["low", "medium", "high", "xhigh", "max"], },}テスト
直接の 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 cannot connect
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 を一致するように更新してください。ツールを含む完全なエージェントターンには、直接の 1 メッセージ curl リクエストよりも大幅に多くのコンテキストが必要です。
Think Max does not activate
ds4 が Think Max を使用するのは、--ctx が少なくとも 393216 で、リクエストが reasoning_effort: "max" を要求している場合のみです。より小さいコンテキストでは high reasoning にフォールバックします。
The first request is slow
ds4 には Metal 常駐のコールドスタートとモデルウォームアップの段階があります。OpenClaw がオンデマンドでサーバーを起動する場合は、localService.readyTimeoutMs: 300000 を使用してください。
