> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek

[DeepSeek](https://www.deepseek.com)는 OpenAI 호환 API를 갖춘 강력한 AI 모델을 제공합니다.

| 속성     | 값                          |
| ------ | -------------------------- |
| 공급자    | `deepseek`                 |
| 인증     | `DEEPSEEK_API_KEY`         |
| API    | OpenAI 호환                  |
| 기본 URL | `https://api.deepseek.com` |

## Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart
```

## 시작하기

<Steps>
  <Step title="Get your API key">
    [platform.deepseek.com](https://platform.deepseek.com/api_keys)에서 API 키를 생성합니다.
  </Step>

  <Step title="Run onboarding">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice deepseek-api-key
    ```

    그러면 API 키를 입력하라는 메시지가 표시되고 `deepseek/deepseek-v4-flash`가 기본 모델로 설정됩니다.
  </Step>

  <Step title="Verify models are available">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider deepseek
    ```

    실행 중인 Gateway 없이 Plugin의 정적 카탈로그를 검사하려면
    다음을 사용합니다.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --all --provider deepseek
    ```
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Non-interactive setup">
    스크립트 기반 또는 헤드리스 설치의 경우 모든 플래그를 직접 전달합니다.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --non-interactive \
      --mode local \
      --auth-choice deepseek-api-key \
      --deepseek-api-key "$DEEPSEEK_API_KEY" \
      --skip-health \
      --accept-risk
    ```
  </Accordion>
</AccordionGroup>

<Warning>
  Gateway가 데몬(launchd/systemd)으로 실행되는 경우 `DEEPSEEK_API_KEY`가
  해당 프로세스에서 사용할 수 있는지 확인하세요(예: `~/.openclaw/.env` 또는
  `env.shellEnv`를 통해).
</Warning>

## 기본 제공 카탈로그

| 모델 참조                        | 이름                | 입력   | 컨텍스트      | 최대 출력   | 참고                   |
| ---------------------------- | ----------------- | ---- | --------- | ------- | -------------------- |
| `deepseek/deepseek-v4-flash` | DeepSeek V4 Flash | text | 1,000,000 | 384,000 | 기본 모델; V4 사고 가능 표면   |
| `deepseek/deepseek-v4-pro`   | DeepSeek V4 Pro   | text | 1,000,000 | 384,000 | V4 사고 가능 표면          |
| `deepseek/deepseek-chat`     | DeepSeek Chat     | text | 131,072   | 8,192   | DeepSeek V3.2 비사고 표면 |
| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | text | 131,072   | 65,536  | 추론 활성화 V3.2 표면       |

<Tip>
  V4 모델은 DeepSeek의 `thinking` 제어를 지원합니다. OpenClaw는 후속 턴에서
  DeepSeek `reasoning_content`도 재생하므로 도구 호출이 포함된 사고 세션을
  계속할 수 있습니다.
  DeepSeek V4 모델에서 DeepSeek의 최대 `reasoning_effort`를 요청하려면
  `/think xhigh` 또는 `/think max`를 사용하세요.
</Tip>

## 사고와 도구

DeepSeek V4 사고 세션은 대부분의 OpenAI 호환 공급자보다 더 엄격한 재생
계약을 가집니다. 사고가 활성화된 턴에서 도구를 사용한 후, DeepSeek는
후속 요청에서 해당 턴의 재생된 assistant 메시지에 `reasoning_content`가
포함되어 있기를 기대합니다. OpenClaw는 DeepSeek Plugin 내부에서 이를
처리하므로 일반적인 멀티턴 도구 사용은 `deepseek/deepseek-v4-flash` 및
`deepseek/deepseek-v4-pro`와 함께 작동합니다.

기존 세션을 다른 OpenAI 호환 공급자에서 DeepSeek V4 모델로 전환하면,
이전 assistant 도구 호출 턴에 네이티브 DeepSeek `reasoning_content`가
없을 수 있습니다. OpenClaw는 DeepSeek V4 사고 요청에서 재생된 assistant
메시지의 누락된 필드를 채워, `/new` 없이도 공급자가 기록을 수락할 수
있도록 합니다.

OpenClaw에서 사고가 비활성화된 경우(UI **None** 선택 포함),
OpenClaw는 DeepSeek `thinking: { type: "disabled" }`를 보내고 나가는
기록에서 재생된 `reasoning_content`를 제거합니다. 이렇게 하면 사고가
비활성화된 세션이 비사고 DeepSeek 경로에 유지됩니다.

기본 빠른 경로에는 `deepseek/deepseek-v4-flash`를 사용하세요. 더 강력한
V4 모델이 필요하고 더 높은 비용이나 지연 시간을 감수할 수 있다면
`deepseek/deepseek-v4-pro`를 사용하세요.

## 라이브 테스트

직접 라이브 모델 제품군에는 최신 모델 세트의 DeepSeek V4가 포함됩니다.
DeepSeek V4 직접 모델 검사만 실행하려면 다음을 사용합니다.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

이 라이브 검사는 두 V4 모델 모두 완료할 수 있는지와 사고/도구 후속 턴이
DeepSeek에서 요구하는 재생 페이로드를 보존하는지 확인합니다.

## 구성 예시

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { DEEPSEEK_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-flash" },
    },
  },
}
```

## 관련 항목

<CardGroup cols={2}>
  <Card title="Model selection" href="/ko/concepts/model-providers" icon="layers">
    공급자, 모델 참조, 장애 조치 동작 선택.
  </Card>

  <Card title="Configuration reference" href="/ko/gateway/configuration-reference" icon="gear">
    에이전트, 모델, 공급자에 대한 전체 구성 참조.
  </Card>
</CardGroup>