Providers
DeepSeek
DeepSeek는 OpenAI 호환 API를 갖춘 강력한 AI 모델을 제공합니다.
| 속성 | 값 |
|---|---|
| 제공자 | deepseek |
| 인증 | DEEPSEEK_API_KEY |
| API | OpenAI 호환 |
| 기본 URL | https://api.deepseek.com |
시작하기
API 키 받기
platform.deepseek.com에서 API 키를 생성합니다.
온보딩 실행
openclaw onboard --auth-choice deepseek-api-key
그러면 API 키 입력을 요청하고 deepseek/deepseek-v4-flash를 기본 모델로 설정합니다.
모델 사용 가능 여부 확인
openclaw models list --provider deepseek
실행 중인 Gateway 없이 번들된 정적 카탈로그를 확인하려면 다음을 사용하세요.
openclaw models list --all --provider deepseek
비대화형 설정
스크립트 또는 헤드리스 설치의 경우 모든 플래그를 직접 전달하세요.
openclaw onboard --non-interactive \
--mode local \
--auth-choice deepseek-api-key \
--deepseek-api-key "$DEEPSEEK_API_KEY" \
--skip-health \
--accept-risk
내장 카탈로그
| 모델 참조 | 이름 | 입력 | 컨텍스트 | 최대 출력 | 참고 |
|---|---|---|---|---|---|
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 표면 |
사고와 도구
DeepSeek V4 사고 세션은 대부분의 OpenAI 호환 제공자보다 더 엄격한 재생 계약을 가집니다. 사고가 활성화된 턴에서 도구를 사용한 후에는 DeepSeek가 후속 요청에서 해당 턴의 재생된 어시스턴트 메시지에 reasoning_content가 포함되기를 기대합니다. OpenClaw는 DeepSeek Plugin 내부에서 이를 처리하므로 일반적인 멀티턴 도구 사용은 deepseek/deepseek-v4-flash 및 deepseek/deepseek-v4-pro에서 작동합니다.
기존 세션을 다른 OpenAI 호환 제공자에서 DeepSeek V4 모델로 전환하면 이전 어시스턴트 도구 호출 턴에 네이티브 DeepSeek reasoning_content가 없을 수 있습니다. OpenClaw는 DeepSeek V4 사고 요청을 위해 재생된 어시스턴트 메시지의 누락된 필드를 채워 제공자가 /new 없이도 기록을 수락할 수 있게 합니다.
OpenClaw에서 사고가 비활성화된 경우(UI 없음 선택 포함), OpenClaw는 DeepSeek thinking: { type: "disabled" }를 보내고 나가는 기록에서 재생된 reasoning_content를 제거합니다. 이렇게 하면 사고 비활성화 세션이 비사고 DeepSeek 경로에 유지됩니다.
기본 빠른 경로에는 deepseek/deepseek-v4-flash를 사용하세요. 더 강력한 V4 모델을 원하고 더 높은 비용이나 지연 시간을 감수할 수 있다면 deepseek/deepseek-v4-pro를 사용하세요.
라이브 테스트
직접 라이브 모델 제품군에는 최신 모델 세트의 DeepSeek V4가 포함됩니다. DeepSeek V4 직접 모델 검사만 실행하려면 다음을 사용하세요.
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에 필요한 재생 페이로드를 보존하는지 확인합니다.
설정 예시
{
env: { DEEPSEEK_API_KEY: "sk-..." },
agents: {
defaults: {
model: { primary: "deepseek/deepseek-v4-flash" },
},
},
}