DeepSeek Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: DeepSeek

개요

이 페이지는 OpenClaw DeepSeek provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: DeepSeek setup (auth + model selection)

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Property	Value
Provider	deepseek
Auth	DEEPSEEK_API_KEY
API	OpenAI-compatible
Base URL	https://api.deepseek.com

공식 문서 기반 상세

아래는 공식 providers/deepseek 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

DeepSeek provides powerful AI models with an OpenAI-compatible API.

Property	Value
Provider	deepseek
Auth	DEEPSEEK_API_KEY
API	OpenAI-compatible
Base URL	https://api.deepseek.com

Install plugin

Install the official plugin, then restart Gateway:

openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

시작하기

Get your API key

Create an API key at [platform.deepseek.com](https://platform.deepseek.com/api_keys).

Run onboarding

```bash
openclaw onboard --auth-choice deepseek-api-key
```

Prompts for your API key and sets `deepseek/deepseek-v4-flash` as the default model.

Verify models are available

```bash
openclaw models list --provider deepseek
```

To inspect the plugin's static catalog without a running Gateway:

```bash
openclaw models list --all --provider deepseek
```

Non-interactive setup

For scripted or headless installations, pass all flags directly:

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
```

If Gateway runs as a daemon (launchd/systemd), make sure DEEPSEEK_API_KEY is available to that process (for example, in ~/.openclaw/.env or via env.shellEnv).

Built-in catalog

Model ref	Name	Input	Context	Max output	Notes
deepseek/deepseek-v4-flash	DeepSeek V4 Flash	text	1,000,000	384,000	Default model; V4 thinking-capable surface
deepseek/deepseek-v4-pro	DeepSeek V4 Pro	text	1,000,000	384,000	V4 thinking-capable surface
deepseek/deepseek-chat	DeepSeek Chat	text	1,000,000	384,000	Deprecated V4 Flash non-thinking compatibility name
deepseek/deepseek-reasoner	DeepSeek Reasoner	text	1,000,000	384,000	Deprecated V4 Flash thinking compatibility name

DeepSeek will retire deepseek-chat and deepseek-reasoner on July 24, 2026 at 15:59 UTC. They currently route to DeepSeek V4 Flash in non-thinking and thinking mode, respectively. Move configured model refs to deepseek/deepseek-v4-flash or deepseek/deepseek-v4-pro before the cutoff.

OpenClaw's local cost estimates follow DeepSeek's published cache-hit, cache-miss, and output rates. DeepSeek can change those rates; its Models & Pricing page is authoritative for billing.

V4 models support DeepSeek's thinking control. OpenClaw also replays DeepSeek reasoning_content on follow-up turns so thinking sessions with tool calls can continue. Use /think xhigh or /think max with DeepSeek V4 models to request DeepSeek's maximum reasoning_effort; both map to "max".

Thinking and tools

DeepSeek V4 thinking sessions require replayed assistant messages from a thinking-enabled turn to include reasoning_content on follow-up requests. OpenClaw's DeepSeek plugin backfills that field automatically, so normal multi-turn tool use works on deepseek/deepseek-v4-flash and deepseek/deepseek-v4-pro even when history came from another OpenAI-compatible provider (no native reasoning_content) or from a plain assistant message. No /new required after switching providers mid-session.

When thinking is disabled (including the UI None selection), OpenClaw sends thinking: { type: "disabled" } and strips replayed reasoning_content from outgoing history, keeping the session on the non-thinking DeepSeek path.

Use deepseek/deepseek-v4-flash for the default fast path. Use deepseek/deepseek-v4-pro for the stronger model when you can accept higher cost or latency.

Live testing

To run only the DeepSeek V4 direct-model checks from the modern model live suite:

OPENCLAW_LIVE_PROVIDERS=deepseek \
OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \
pnpm test:live src/agents/models.profiles.live.test.ts

Verifies both V4 models complete and that thinking/tool follow-up turns preserve the replay payload DeepSeek requires.

설정 예시

{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-flash" },
    },
  },
}

관련 문서

Choosing providers, model refs, and failover behavior.


Full config reference for agents, models, and providers.

검증 체크리스트

• openclaw models list --provider deepseek 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers