Providers

DeepSeek

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

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

Plugin 설치

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

bash
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restart

시작하기

  • Get your API key

    platform.deepseek.com에서 API 키를 생성합니다.

  • Run onboarding

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

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

  • Verify models are available

    bash
    openclaw models list --provider deepseek

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

    bash
    openclaw models list --all --provider deepseek
  • Non-interactive setup

    스크립트 기반 또는 헤드리스 설치의 경우 모든 플래그를 직접 전달합니다.

    bash
    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는 후속 요청에서 해당 턴의 재생된 assistant 메시지에 reasoning_content가 포함되어 있기를 기대합니다. OpenClaw는 DeepSeek Plugin 내부에서 이를 처리하므로 일반적인 멀티턴 도구 사용은 deepseek/deepseek-v4-flashdeepseek/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
    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
    {  env: { DEEPSEEK_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "deepseek/deepseek-v4-flash" },    },  },}

    관련 항목

    Was this useful?
    On this page

    On this page