How the integration works
OpenClaw accepts custom providers in its models configuration. Add DeepSeek-V4.io, reference the API key through an environment variable, and make DeepSeek V4 Flash the default agent model.
Create and manage it on /developer.
The client talks to its native compatible endpoint.
Provider credentials and routing stay on the server.
Before you start
- OpenClaw installed
- A paid DeepSeek-V4.io account with an API key from /developer
- Access to ~/.openclaw/openclaw.json
Configure OpenClaw
{
"models": {
"providers": {
"deepseek-v4-io": {
"baseUrl": "https://deepseek-v4.io/api/v1",
"apiKey": "${DEEPSEEK_V4_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "deepseek-v4-flash",
"name": "DeepSeek V4 Flash",
"reasoning": true,
"input": ["text"],
"contextWindow": 1048576,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "deepseek-v4-io/deepseek-v4-flash"
}
}
}
}export DEEPSEEK_V4_API_KEY="your-deepseek-v4-io-key"
openclawVerify the setup
The page remains Experimental until these checks pass against the public DeepSeek-V4.io gateway.
- 1Confirm the default model resolves to deepseek-v4-io/deepseek-v4-flash.
- 2Run an agent task that requires one safe tool call.
- 3Confirm streaming continues after the tool result is returned.
Troubleshooting
Provider is not loaded
Validate ~/.openclaw/openclaw.json and confirm the provider is nested under models.providers.
Environment variable is not expanded
Export DEEPSEEK_V4_API_KEY in the environment that launches OpenClaw, then restart it.
Wrong default model
Use deepseek-v4-io/deepseek-v4-flash as agents.defaults.model.primary.
Sources and support boundary
Configuration fields are checked against the tool publisher's documentation. DeepSeek-V4.io owns this gateway guide and support for its endpoint; it does not represent the tool publisher.
OpenClaw model provider documentationReady to connect OpenClaw?
Create a DeepSeek-V4.io API key, copy the configuration above, and verify one read-only tool call before using it on a real project.
Open Developer Dashboard