Langsung ke konten utama
DeepSeek menyediakan model AI yang kuat dengan API yang kompatibel dengan OpenAI.
PropertiNilai
Penyediadeepseek
AutentikasiDEEPSEEK_API_KEY
APIKompatibel dengan OpenAI
URL Dasarhttps://api.deepseek.com

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

Memulai

1

Dapatkan kunci API Anda

Buat kunci API di platform.deepseek.com.
2

Jalankan onboarding

openclaw onboard --auth-choice deepseek-api-key
Ini akan meminta kunci API Anda dan menetapkan deepseek/deepseek-v4-flash sebagai model default.
3

Verifikasi model tersedia

openclaw models list --provider deepseek
Untuk memeriksa katalog statis Plugin tanpa memerlukan Gateway yang sedang berjalan, gunakan:
openclaw models list --all --provider deepseek
Untuk instalasi berskrip atau tanpa antarmuka, teruskan semua flag secara langsung:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan DEEPSEEK_API_KEY tersedia untuk proses tersebut (misalnya, di ~/.openclaw/.env atau melalui env.shellEnv).

Katalog bawaan

Ref modelNamaInputKonteksOutput maksCatatan
deepseek/deepseek-v4-flashDeepSeek V4 Flashteks1,000,000384,000Model default; permukaan V4 yang mendukung pemikiran
deepseek/deepseek-v4-proDeepSeek V4 Proteks1,000,000384,000Permukaan V4 yang mendukung pemikiran
deepseek/deepseek-chatDeepSeek Chatteks131,0728,192Permukaan DeepSeek V3.2 tanpa pemikiran
deepseek/deepseek-reasonerDeepSeek Reasonerteks131,07265,536Permukaan V3.2 dengan penalaran aktif
Model V4 mendukung kontrol thinking DeepSeek. OpenClaw juga memutar ulang reasoning_content DeepSeek pada giliran lanjutan agar sesi pemikiran dengan panggilan alat dapat berlanjut. Gunakan /think xhigh atau /think max dengan model DeepSeek V4 untuk meminta reasoning_effort maksimum DeepSeek.

Pemikiran dan alat

Sesi pemikiran DeepSeek V4 memiliki kontrak pemutaran ulang yang lebih ketat daripada sebagian besar penyedia yang kompatibel dengan OpenAI: setelah giliran dengan pemikiran aktif menggunakan alat, DeepSeek mengharapkan pesan asisten yang diputar ulang dari giliran tersebut menyertakan reasoning_content pada permintaan lanjutan. OpenClaw menangani ini di dalam Plugin DeepSeek, sehingga penggunaan alat multi-giliran normal berfungsi dengan deepseek/deepseek-v4-flash dan deepseek/deepseek-v4-pro. Jika Anda mengalihkan sesi yang sudah ada dari penyedia lain yang kompatibel dengan OpenAI ke model DeepSeek V4, giliran panggilan alat asisten lama mungkin tidak memiliki reasoning_content asli DeepSeek. OpenClaw mengisi kolom yang hilang itu pada pesan asisten yang diputar ulang untuk permintaan pemikiran DeepSeek V4 sehingga penyedia dapat menerima riwayat tanpa memerlukan /new. Saat pemikiran dinonaktifkan di OpenClaw (termasuk pilihan UI Tidak ada), OpenClaw mengirim thinking: { type: "disabled" } DeepSeek dan menghapus reasoning_content yang diputar ulang dari riwayat keluar. Ini menjaga sesi dengan pemikiran nonaktif tetap berada di jalur DeepSeek tanpa pemikiran. Gunakan deepseek/deepseek-v4-flash untuk jalur cepat default. Gunakan deepseek/deepseek-v4-pro saat Anda menginginkan model V4 yang lebih kuat dan dapat menerima biaya atau latensi yang lebih tinggi.

Pengujian live

Suite model live langsung menyertakan DeepSeek V4 dalam set model modern. Untuk menjalankan hanya pemeriksaan model langsung 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
Pemeriksaan live tersebut memverifikasi bahwa kedua model V4 dapat menyelesaikan tugas dan bahwa giliran lanjutan pemikiran/alat mempertahankan payload pemutaran ulang yang diwajibkan DeepSeek.

Contoh konfigurasi

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

Terkait

Pemilihan model

Memilih penyedia, ref model, dan perilaku failover.

Referensi konfigurasi

Referensi konfigurasi lengkap untuk agen, model, dan penyedia.