← All integrations
General agentOpenAI Chat CompletionsExperimental

Use DeepSeek V4 with OpenClaw

Register DeepSeek-V4.io as a custom OpenAI Completions provider in OpenClaw.

DeepSeek-V4.io is an independent API gateway, not the official DeepSeek website. A paid DeepSeek-V4.io key is required.

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.

One site key

Create and manage it on /developer.

OpenAI Chat Completions

The client talks to its native compatible endpoint.

Upstream hidden

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

1.Configure ~/.openclaw/openclaw.json
{
  "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"
      }
    }
  }
}
2.Set the key and start OpenClaw
export DEEPSEEK_V4_API_KEY="your-deepseek-v4-io-key"
openclaw

Verify the setup

The page remains Experimental until these checks pass against the public DeepSeek-V4.io gateway.

  1. 1Confirm the default model resolves to deepseek-v4-io/deepseek-v4-flash.
  2. 2Run an agent task that requires one safe tool call.
  3. 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 documentation

Ready 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