OpenClaw dengan DeepSeek: Penyiapan, ID Model, dan Biaya API

OpenClaw menjangkau DeepSeek melalui plugin penyedia resmi yang dipasang secara terpisah — openclaw plugins install @openclaw/deepseek-provider — dengan ID penyedia deepseek, kunci DEEPSEEK_API_KEY, API yang kompatibel dengan OpenAI, dan URL dasar https://api.deepseek.com tanpa /v1. Dua fakta menentukan apakah proses pertama Anda berhasil. Katalog live DeepSeek memiliki dua ID, deepseek-flash dan deepseek-v4-pro; nama deepseek-chat dan deepseek-reasoner yang digunakan tutorial lama dihentikan pada 24 Juli 2026. Dan onboarding OpenClaw menetapkan deepseek/deepseek-v4-pro sebagai default Anda, yaitu satu-satunya model yang penagihan terkininya diperdebatkan oleh halaman DeepSeek sendiri.

Satu klarifikasi sebelum konfigurasi, karena hasil pencarian mencampuradukkannya. OpenClaw lain di GitHub mendeskripsikan dirinya sebagai "reimplementasi C++ multiplatform dari game platformer Captain Claw (1997) asli"; tidak ada bagian darinya yang berlaku di sini. Agen yang dimaksud adalah proyek di openclaw.ai, yang didokumentasikan di docs.openclaw.ai — tautkan host tersebut, karena documentation.openclaw.ai hanya mengarahkannya ke sana.

Pasang dan konfigurasikan sesuai dokumentasi kedua proyek

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Setelah plugin terpasang, Anda tidak perlu memberikan URL dasar: plugin menerbitkan katalognya sendiri dan perilaku kompatibilitasnya sendiri. Konfigurasi minimalnya adalah kunci dan model, dalam JSON5.

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

OpenClaw menyelesaikan kunci penyedia dari empat bentuk variabel lingkungan dalam urutan prioritas yang terdokumentasi: OPENCLAW_LIVE_DEEPSEEK_KEY sebagai satu pengesamping live dengan prioritas tertinggi, lalu DEEPSEEK_API_KEYS sebagai daftar yang dipisahkan koma atau titik koma, kemudian DEEPSEEK_API_KEY sebagai kunci utama, lalu entri bernomor DEEPSEEK_API_KEY_* (UI Kontrol dan kunci, diperiksa pada 21 September 2026). Settings lalu Models di UI Kontrol menambahkan atau mengganti kunci tanpa mengedit file, dan materi kunci tetap berada di penyimpanan autentikasi. Jebakan untuk instalasi server adalah cakupannya, bukan ejaannya: halaman OpenClaw sendiri memperingatkan bahwa jika Gateway berjalan sebagai daemon di bawah launchd atau systemd, kunci tersebut harus terlihat oleh proses tersebut, misalnya di ~/.openclaw/.env atau melalui env.shellEnv.

ID model DeepSeek mana yang sebenarnya masih aktif

Baris-baris di bawah memiliki tiga status berbeda, bukan satu. Respons contoh dalam referensi list-models DeepSeek menampilkan tepat dua ID, deepseek-flash dan deepseek-v4-pro, sedangkan katalog bawaan OpenClaw masih menawarkan empat referensi.

Pisahkan kedua pernyataan penghentian tersebut, karena sekilas tampak kontradiktif padahal tidak. OpenClaw menyatakan bahwa DeepSeek menghentikan deepseek-chat dan deepseek-reasoner serta bahwa "ID model tersebut tidak lagi dapat diakses". DeepSeek secara terpisah menyatakan bahwa "nama legacy deepseek-v4-flash dan deepseek-v4-flash-vision-exp masih diterima, tetapi model yang bersangkutan telah dihentikan". Dua pasang nama yang berbeda, dengan dua hasil yang berbeda. Halaman Models & Pricing DeepSeek memberikan panjang konteks 1M dan output maksimum 384K untuk kedua ID live, dan tabel katalog OpenClaw memuat pasangan 1.000.000 / 384.000 yang sama pada keempat referensinya.

Bagian yang belum terselesaikan. Pengumuman 10 September 2026 DeepSeek menyatakan "Kami sedang menghentikan V4-Pro secara bertahap" dan bahwa "mulai 04:00 UTC pada 14 September 2026, semua permintaan deepseek-v4-pro akan dialihkan ke V4.1-Flash dengan tarif V4.1-Flash". Log perubahan untuk rilis yang sama menyatakan sebaliknya: "menanggapi permintaan pengguna, kami memutuskan untuk terus menyediakan layanan API untuk DeepSeek V4 Pro setelah 14 September 2026, dengan metode penagihan tetap tidak berubah". Halaman Models & Pricing masih mencantumkan V4 Pro dengan tarifnya sendiri yang lebih tinggi dan tidak memuat pemberitahuan penghentian. Keduanya dibaca pada 21 September 2026, seminggu setelah tanggal yang dipermasalahkan. Halaman ini tidak akan memberi tahu Anda mana yang menagih Anda — konfirmasikan di akun DeepSeek Anda sendiri sebelum membiarkan default onboarding tetap digunakan, dan perhatikan bahwa default tersebut tepatnya adalah model yang diperdebatkan.

Biaya token dan alasan waktu menjadi bagian dari harga

DeepSeek menerbitkan tarif peak dan off-peak, dengan off-peak setengah dari peak. Jendelanya sempit: "jam peak adalah 01:00 - 04:00 dan 06:00 - 10:00 UTC, Senin hingga Jumat, tidak termasuk hari libur umum Tiongkok. Semua jam lainnya adalah off-peak, termasuk akhir pekan dan seluruh hari libur umum Tiongkok." Tujuh jam pada hari kerja adalah peak dan semua waktu lainnya bukan, sehingga perkiraan yang diam-diam mengasumsikan peak akan melebihkan tagihan tipikal.

Dibaca dari halaman Models & Pricing DeepSeek pada 21 September 2026. Baris Flash diperkuat secara independen oleh halaman penyedia OpenClaw, yang menyebut "$0,30 per juta token input, $1,20 per juta token output, dan $0,006 per juta token input yang di-cache". Baris V4 Pro hanya bersandar pada halaman Models & Pricing dan berada di bawah kontradiksi di atas, jadi perlakukan sebagai kutipan, bukan fakta yang telah ditetapkan.

Kolom cache adalah bagian yang mengubah tagihan agen, dan rasionya tidak biasa. Cache hit pada deepseek-flash berharga $0,006 per juta dibandingkan $0,30 untuk miss — kira-kira seperlima puluh tarif miss, jauh di bawah rasio sepersepuluh yang umum di tempat lain, jadi jangan membawa asumsi dari vendor lain. Panduan caching DeepSeek menyatakan bahwa fitur tersebut "diaktifkan secara default untuk semua pengguna, tanpa perlu mengubah kode mereka", bahwa hit memerlukan prefiks yang sepenuhnya cocok, dan bahwa cache yang tidak digunakan dihapus "biasanya dalam beberapa jam hingga beberapa hari". Hit dan miss dikembalikan dalam kolom penggunaan prompt_cache_hit_tokens dan prompt_cache_miss_tokens. DeepSeek tidak menerbitkan harga penulisan cache, dan tabel harganya tidak memiliki kolom penulisan cache; ini adalah biaya yang tidak diterbitkan, bukan pernyataan bahwa penulisan gratis.

Sesi ilustratif pada deepseek-flash, dengan tarif yang diterbitkan DeepSeek. Misalkan satu proses OpenClaw mengirim 600.000 token input, dengan 450.000 di antaranya cocok dengan cache prefiks dan 150.000 tidak, serta menerima 40.000 token output. Pada jam sibuk, biayanya $0,045 ditambah $0,0027 ditambah $0,048, atau $0,096; sesi yang sama di luar jam sibuk adalah $0,048. Proses yang sama tanpa cache hit sama sekali akan berharga $0,228 pada jam sibuk. Ini adalah perhitungan token berdasarkan asumsi yang dinyatakan, bukan biaya tugas terukur dan bukan batas maksimum pengeluaran — proporsi cache hit Anda sendirilah yang paling penting, dan angka dalam aplikasi OpenClaw tidak dapat memastikannya, karena OpenClaw menyatakan biaya lokalnya adalah perkiraan dan menunjuk halaman harga DeepSeek sebagai sumber otoritatif untuk penagihan.

Kapabilitas model dan dukungan alat klien adalah dua pertanyaan yang berbeda

Inilah bagian yang tidak dapat diberitahukan oleh tabel harga, dan alasan praktis untuk menggunakan plugin, bukan entri penyedia yang dibuat manual. Sesi berpikir DeepSeek V4 memerlukan pesan assistant yang diputar ulang dari giliran yang mendukung thinking untuk membawa reasoning_content pada permintaan lanjutan. Plugin DeepSeek OpenClaw mengisi kolom tersebut secara otomatis, sehingga penggunaan alat multi-giliran berfungsi "bahkan ketika riwayat berasal dari penyedia lain yang kompatibel dengan OpenAI (tanpa reasoning_content native) atau dari pesan assistant biasa", tanpa memerlukan /new setelah berganti penyedia di tengah sesi. Saat thinking dinonaktifkan, termasuk pilihan None di UI, OpenClaw mengirim thinking: { type: "disabled" } dan menghapus reasoning_content yang diputar ulang dari riwayat keluar. OpenClaw juga memetakan /think xhigh dan /think max ke maksimum DeepSeek untuk reasoning_effort.

Penyedia kustom generik openai-completions yang diarahkan ke endpoint yang kompatibel dengan DeepSeek tidak mendapatkan pengisian ulang tersebut, dan tidak mendapatkan format thinking DeepSeek kecuali Anda mendeklarasikan blok kompatibilitasnya sendiri — halaman ds4 OpenClaw menunjukkan bentuknya, termasuk thinkingFormat: "deepseek" dan supportsReasoningEffort. Kesenjangan tersebut biasanya menjelaskan giliran alat yang berhasil sekali lalu gagal pada giliran lanjutan.

Dua batasan dari sisi DeepSeek perlu dipertimbangkan dalam keputusan yang sama. Pemanggilan alat strict-mode berada di URL dasar yang berbeda, https://api.deepseek.com/beta, dan memerlukan "strict": true pada setiap fungsi serta "additionalProperties": false; plugin tidak diarahkan ke sana secara default. Dan panduan pemanggilan alat DeepSeek menyatakan bahwa "Chat Completion API tidak mendukung penyisipan panggilan alat di tengah percakapan, tetapi mendukung penyisipan pesan system di tengah percakapan; untuk menyisipkan panggilan alat, gunakan Anthropic API atau Responses API" — batasan endpoint yang digunakan plugin OpenClaw, dengan dua alternatif terdokumentasi, bukan batasan model.

Mengenai dukungan model, kedua sumber sepakat. Kolom FEATURES pada halaman Models & Pricing DeepSeek menandai Tool Calls, JSON Output, Responses API, dan Anthropic API sebagai didukung pada deepseek-flash dan deepseek-v4-pro, serta membedakan dukungan vision — didukung pada deepseek-flash, tidak didukung pada deepseek-v4-pro. OpenClaw menyatakan bahwa penggunaan alat multi-giliran berfungsi pada keempat referensinya. Yang tidak didokumentasikan oleh kedua pihak adalah panggilan alat paralel, sehingga hal tersebut benar-benar masih terbuka dan belum dijawab ke arah mana pun.

Verifikasi dalam tiga langkah, lalu kegagalan yang perlu disebutkan

Periksa lapisannya secara berurutan karena masing-masing gagal dengan cara berbeda. Pertama, katalog: openclaw models list --provider deepseek, atau openclaw models list --all --provider deepseek untuk memeriksa katalog statis plugin tanpa Gateway yang berjalan, lalu openclaw models set deepseek/deepseek-flash jika Anda menginginkan model yang tidak diperdebatkan, bukan default onboarding. Kedua, satu prompt singkat non-streaming lalu prompt streaming, yang merupakan tempat masalah autentikasi atau URL dasar muncul dengan jelas. Ketiga — dan hanya ketiga — panggilan alat yang diikuti giliran kedua dalam sesi yang sama, satu-satunya langkah yang menguji pemutaran ulang reasoning_content yang dijelaskan di atas.

Baris 404 layak mendapat kalimatnya sendiri, karena inilah hal yang tidak dapat dijelaskan oleh dokumentasi untuk Anda. Tabel kode kesalahan DeepSeek mencantumkan 400, 401, 402, 422, 429, 500, dan 503 serta tidak memuat 404, jadi 404 di sini merupakan bukti tentang perutean Anda, bukan tentang DeepSeek. Apa yang sebenarnya dikembalikan DeepSeek untuk ID model yang tidak dikenal tidak terdokumentasi dan belum diuji di sini. Referensi kesalahan mencakup kode status yang setara pada endpoint milik Kunavo sendiri.

Langsung, gateway, lokal: rute mana yang menang

Kunavo tidak menyediakan model DeepSeek. Model teksnya berasal dari keluarga Claude dan OpenAI, jadi tidak ada rute Kunavo ke model DeepSeek dan halaman ini tidak menawarkannya. Yang dapat diterapkan adalah mekanismenya, yang perlu diketahui jika alasan Anda membaca halaman penyiapan DeepSeek adalah karena Anda menginginkan satu kunci untuk berbagai keluarga model, bukan DeepSeek secara khusus.

Untuk baris gateway, konfigurasinya menggunakan dua pengaturan yang sama. Deklarasikan models.providers.<id> dengan baseUrl, apiKey, api: "openai-completions", dan array models[] yang mencantumkan setidaknya setiap id, atau lakukan onboarding ke endpoint dengan --auth-choice custom-api-key, --custom-base-url, dan --custom-model-id. Referensi model selalu berbentuk provider/model, dan kegagalan diam-diam terjadi ketika model diberi alias di bawah agents.defaults.models tanpa didaftarkan di models.providers.<provider>.models[] — referensi penyedia khusus OpenClaw menyatakan bahwa alias tersebut "tidak membatasi penggantian maupun mendaftarkan model runtime baru dengan sendirinya". URL dasar Kunavo untuk rute ini adalah https://api.kunavo.com/v1, dengan tepat satu /v1 — kebalikan dari konvensi tanpa sufiks milik DeepSeek, dan kemungkinan besar sumber 404 ketika seseorang menyalin nilai dari satu halaman ke kolom halaman lainnya.

Untuk memperoleh gambaran skala alternatif tersebut, berikut bentuk sesi asumsi yang sama — 600.000 token input dan 40.000 token output, tanpa mengasumsikan cache — dengan harga berdasarkan tarif katalog Kunavo yang berlaku. Ini adalah model berbeda pada endpoint berbeda, jadi ini merupakan perbandingan bentuk dan bukan perbandingan biaya untuk tugas yang sama dengan angka DeepSeek di atas; tarif terendah yang tercantum dan biaya terendah untuk menyelesaikan tugas merupakan klaim yang terpisah, dan hanya proses Anda sendiri yang dapat menetapkan klaim kedua.

Perhitungan token ilustratif berdasarkan asumsi yang dinyatakan, bukan biaya tugas yang diukur dan bukan batas maksimum tagihan. Jumlah katalog Kunavo merupakan batas bawah penagihan, bukan batas atas: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream dikalikan markup yang berlaku. Biaya cache dan alat eksternal berada di luar contoh ini. Isi ulang minimum adalah $10 dalam kredit prabayar — minimum pendanaan, bukan biaya tugas atau langganan. Lihat detail penagihan dan caching.

Jika rute terkait itulah yang sebenarnya Anda inginkan, mulai dari ikhtisar integrasi untuk URL dasar dan penyiapan kunci, lalu mulai cepat untuk panggilan pertama, dan buat akun Kunavo ketika Anda siap mendanai kunci. Perlakukan ini sebagai referensi konfigurasi yang dipublikasikan, bukan hasil kompatibilitas: OpenClaw belum diuji saat runtime terhadap endpoint Kunavo. Tetap menggunakan OpenClaw dan memilih model? Harga OpenClaw memisahkan perangkat lunak gratis dari tagihan bermeter, API terbaik untuk OpenClaw membandingkan rute berdasarkan tugas, dan API yang kompatibel dengan OpenAI membahas konvensi URL dasar yang terus diperingatkan halaman ini.

Pertanyaan umum

Setiap pernyataan OpenClaw dan DeepSeek di atas dibaca dari dokumentasi dan registri milik proyek tersebut pada 21 September 2026, berdasarkan OpenClaw v2026.9.5; halaman penyedia, halaman harga, changelog, pengumuman 10 September, referensi daftar model, tabel kode kesalahan, halaman batas laju, dan aturan penyedia khusus semuanya diambil ulang secara langsung untuk halaman ini. Tidak ada yang diinstal, dilakukan onboarding, atau dipanggil: tidak ada proses OpenClaw, tidak ada permintaan ke api.deepseek.com, dan tidak ada pengujian runtime terhadap Kunavo. Tarif token Kunavo berasal dari katalog yang berlaku, dan setiap angka dolar merupakan perhitungan token ilustratif, bukan biaya yang diukur.