DeepSeek는 OpenAI 호환 API를 통해 강력한 AI 모델을 제공합니다.

속성	값
프로바이더	deepseek
인증	DEEPSEEK_API_KEY
API	OpenAI 호환
Base URL	https://api.deepseek.com

시작하기

1. API 키 발급

   platform.deepseek.com에서 API 키를 생성하세요.

2. 온보딩 실행

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

    이 명령은 API 키 입력을 요청하고 `deepseek/deepseek-chat`을 기본 모델로 설정합니다.

3. **모델이 사용 가능한지 확인**

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


::: details 비대화형 설정
스크립트 또는 헤드리스 설치의 경우, 모든 플래그를 직접 전달하세요.

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

::: warning
Gateway가 데몬(launchd/systemd)으로 실행 중이라면, `DEEPSEEK_API_KEY`가
해당 프로세스에서 접근 가능한지 확인하세요 (예: `~/.openclaw/.env` 또는
`env.shellEnv`를 통해).
:::


## 내장 카탈로그

| 모델 ref                     | 이름              | 입력 | 컨텍스트 | 최대 출력 | 비고                                                 |
| ---------------------------- | ----------------- | ---- | -------- | --------- | ---------------------------------------------------- |
| `deepseek/deepseek-chat`     | DeepSeek Chat     | text | 131,072  | 8,192     | 기본 모델; DeepSeek V3.2 non-thinking 표면           |
| `deepseek/deepseek-reasoner` | DeepSeek Reasoner | text | 131,072  | 65,536    | 추론(reasoning)이 활성화된 V3.2 표면                 |

::: tip
번들된 두 모델 모두 현재 소스에서 스트리밍 사용량 호환성을 명시하고 있습니다.
:::


## 설정 예시

```json5
{
env: { DEEPSEEK_API_KEY: "sk-..." },
agents: {
 defaults: {
   model: { primary: "deepseek/deepseek-chat" },
 },
},
}

관련 문서

모델 선택 → 프로바이더, 모델 ref, 페일오버 동작 선택.

설정 레퍼런스 → 에이전트, 모델, 프로바이더에 대한 전체 설정 레퍼런스.