Cara Setting API Key OpenRouter di OpenClaw (2026)

TL;DR: Setting API key OpenRouter di OpenClaw ada dua jalur: kirim /login openrouter di chat (atau klik Connect di Control UI) buat OAuth tanpa tempel key manual, atau jalankan openclaw onboard --auth-choice openrouter-api-key kalau kamu sudah punya key dari openrouter.ai/keys. Setelah login tersimpan, model default-nya openrouter/auto; ganti ke model spesifik dengan openclaw models set openrouter/<provider>/<model>, menurut dokumentasi resmi OpenClaw per versi 2026.9.6 (dicek 12 Oktober 2026). Tanpa tempel key manual pun bisa — OAuth otomatis nyimpen key hasil tukar PKCE ke profil auth yang sama.

💡 KEY TAKEAWAY

Satu API key, banyak model: OpenRouter jadi satu endpoint OpenAI-compatible yang meneruskan ke puluhan provider model sekaligus.
Dua cara login: OAuth (browser, tanpa copy-paste key) atau API key manual dari openrouter.ai/keys — dua-duanya disimpan di profil auth openrouter:default yang sama.
Format model ref: openrouter/<provider>/<model>, dengan openrouter/auto sebagai default routing otomatis.
Custom baseUrl hilangkan header atribusi: kalau provider OpenRouter dialihkan ke proxy lain, OpenClaw tidak lagi menyuntik header HTTP-Referer/X-OpenRouter-Title dan marker cache Anthropic.

Kamu sudah install OpenClaw dan sudah (atau belum) punya API key OpenRouter, tapi bingung di mana key itu disetel. Jawaban singkatnya: ketik /login openrouter di chat OpenClaw buat OAuth lewat browser (key dibuatkan otomatis), atau jalankan openclaw onboard --auth-choice openrouter-api-key kalau kamu sudah pegang key dari openrouter.ai/keys — keduanya menyimpan kredensial ke profil auth OpenRouter yang sama, jadi hasil akhirnya identik, cuma beda cara dapetinnya. Bagian di bawah ini bongkar tiap langkah setting-nya di OpenClaw, dari login sampai ganti model dan baca konfigurasi lanjutannya.

Apa Itu OpenRouter dan Kenapa Dipakai di OpenClaw

OpenRouter adalah penyedia layanan routing AI asal Amerika Serikat yang mengoperasikan platform akses dan permintaan ke berbagai model bahasa besar (LLM) dan model AI generatif lain lewat satu API terpadu — sumber: Wikipedia, entri OpenRouter. Dari sisi OpenClaw, OpenRouter diperlakukan sebagai satu provider model yang kompatibel dengan transport openai-completions yang sama dipakai provider proxy lain — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

Keuntungan praktisnya: kamu tidak perlu daftar API key terpisah ke OpenAI, Anthropic, Google, atau provider lain satu per satu. Satu key OpenRouter sudah bisa dipakai ganti-ganti model lewat format ref openrouter/<provider>/<model> yang dijelaskan di bagian ganti model di bawah. Plugin OpenRouter ini sudah dibundel langsung ke OpenClaw sebagai paket @openclaw/openrouter-provider — tidak perlu instalasi tambahan apa pun — sumber: dokumentasi resmi OpenClaw, referensi plugin OpenRouter.

Kalau kamu lagi menimbang OpenRouter dibandingkan opsi gateway AI lain, perbandingan OpenRouter vs 9Router sebagai AI gateway/router membahas sisi self-hosted-nya — tapi jalur yang dibahas di sini adalah setting integrasi native OpenRouter langsung ke OpenClaw, tanpa router pihak ketiga di tengahnya.

Cara Login OpenRouter di OpenClaw: Chat, CLI, OAuth, dan API Key

OpenClaw menyediakan dua jalur login OpenRouter yang menyimpan hasil ke profil auth yang sama (openrouter:default) — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter. Beda cara dapetinnya, sama hasil akhirnya.

Lewat Chat: /login openrouter

Di private chat OpenClaw, kirim /login openrouter atau pilih OpenRouter dari menu /login, lalu pilih Sign in with OpenRouter. Browser kebuka buat approve akses, dan setelah kamu balik ke chat, OpenClaw otomatis menerima callback dan menyimpan kredensialnya. Login lewat jalur ini tidak langsung memilih model starter — kalau restriksi model yang aktif menyembunyikan model OpenRouter, kamu akan ditanya mau Show all OpenRouter models atau Keep current restrictions; kredensialnya tetap tersimpan apa pun pilihannya. /login cancel membatalkan proses sign-in yang masih menggantung. Di Control UI, menu yang setara ada di Settings → Models → Connect, lalu pilih model lewat katalog Gateway.

Lewat CLI: openclaw onboard –auth-choice

Buat setup awal dari terminal, dua command onboarding yang tersedia:

openclaw onboard --auth-choice openrouter-oauth

Command ini membuka flow sign-in browser OpenRouter (PKCE), menukar kode jadi API key OpenRouter, dan menyimpannya ke profil auth OpenRouter default. Di server remote/headless tanpa browser, OpenClaw mencetak URL sign-in dan minta kamu paste URL redirect-nya setelah login — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

openclaw onboard --auth-choice openrouter-api-key

Command ini meminta kamu masukkan API key yang sudah dibuat manual (lihat subbagian berikutnya). Kedua command onboarding ini defaultnya langsung set model ke openrouter/auto.

Kalau OpenClaw-nya sudah pernah di-setup dan kamu cuma mau login ulang atau rotate kredensial OpenRouter tanpa jalanin ulang full onboarding, dua command ini yang dipakai:

openclaw models auth login --provider openrouter --method oauth
openclaw models auth login --provider openrouter --method api-key

OAuth vs API Key Manual

Beda intinya: OAuth login lewat browser dan OpenClaw yang menukar kode jadi key di belakang layar, sedangkan API key manual kamu generate sendiri lebih dulu di openrouter.ai/keys lalu tempel ke OpenClaw. Buat jalur manual, key itu dipakai sebagai input command openclaw onboard --auth-choice openrouter-api-key di atas — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter. Teknis di baliknya pun sama: OpenRouter OAuth itu login PKCE yang pada akhirnya menerbitkan API key OpenRouter juga, jadi hasil OAuth disimpan ke profil auth API-key yang sama persis dipakai setup manual — tidak ada dua sistem kredensial yang berbeda. Kalau kamu belum punya key sama sekali dan mau tahu detail cara bikinnya di dashboard OpenRouter sampai cara pakainya di tool lain, panduan lengkap cara membuat API key OpenRouter membahasnya sendiri — bagian ini fokus ke cara pasangnya di OpenClaw, bukan cara bikin key-nya.

Kalau key lama perlu dirotate (misalnya bocor atau mau diganti scope-nya), caranya: revoke/hapus key lama di openrouter.ai/keys, buat key baru di halaman yang sama, lalu jalankan ulang openclaw models auth login --provider openrouter --method api-key dan masukkan key barunya. Command models auth login ini memang disediakan dokumentasi OpenClaw khusus buat sign-in ulang atau rotate key tanpa onboarding penuh.

Cara Ganti atau Pilih Model OpenRouter di OpenClaw

Model ref OpenRouter di OpenClaw mengikuti pola openrouter/<provider>/<model> — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter. Buat ganti model setelah login, command-nya:

openclaw models set openrouter/<provider>/<model>

Beberapa model starter yang sudah dibundel sebagai baris katalog siap pakai (sumber yang sama):

Model Ref	Keterangan
`openrouter/auto`	Routing otomatis OpenRouter, default onboarding
`openrouter/moonshotai/kimi-k2.6`	Kimi K2.6 via MoonshotAI
`openrouter/moonshotai/kimi-k2.5`	Kimi K2.5 via MoonshotAI

Selain tiga baris starter itu, ref openrouter/<provider>/<model> apa pun — termasuk openrouter/openrouter/fusion yang dibahas di bagian fitur lanjutan — otomatis diselesaikan lewat katalog model OpenRouter yang live, jadi daftar model yang bisa dipakai jauh lebih luas dari tiga baris starter itu. Dukungan tool-calling tiap model mengikuti metadata supported_parameters yang diumumkan OpenRouter sendiri: kalau metadata itu tidak menyebut tools, OpenClaw mengirim request tanpa definisi tool.

Kalau budget jadi concern pas milih model, cek dulu rincian biaya asli OpenRouter dan fee yang perlu dihitung sebelum mengunci satu model berbayar sebagai primary. Kalau mau mulai dari yang gratis dulu, daftar model gratis OpenRouter beserta rate limit-nya bisa jadi titik awal sebelum upgrade ke model berbayar lewat command di atas.

Contoh config.json5: Pasang OPENROUTER_API_KEY Lewat File

Setup manual lewat file config juga didukung, bukan cuma lewat command onboarding — polanya taruh API key di env.vars.OPENROUTER_API_KEY dan set model default di agents.defaults.model.primary — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter:

{
  env: { vars: { OPENROUTER_API_KEY: "sk-or-..." } },
  agents: {
    defaults: {
      model: { primary: "openrouter/auto" },
    },
  },
}

Ganti nilai model.primary dengan ref model spesifik (misalnya openrouter/moonshotai/kimi-k2.6) kalau kamu sudah tahu model mana yang mau dipakai terus-terusan. Baris OPENROUTER_API_KEY ini hanya dipakai kalau kamu setup manual lewat file — kalau login lewat OAuth, baris ini bisa dihilangkan karena key-nya sudah tersimpan otomatis di profil auth.

Fitur Lanjutan OpenRouter di OpenClaw (Provider Routing, Response Caching, Fusion)

Tiga fitur ini opsional — skip bagian ini kalau setup dasar di atas sudah cukup buat kebutuhanmu.

Provider routing. OpenRouter mendukung objek provider buat mengatur provider upstream mana yang dipilih di belakang satu model ref. Di OpenClaw, policy default buat semua request model teks OpenRouter diatur lewat models.providers.openrouter.params.provider, dengan field snake_case resmi OpenRouter seperti sort, only, ignore, order, allow_fallbacks, require_parameters, dan data_collection — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter; detail tiap field provider routing juga didokumentasikan langsung oleh OpenRouter — sumber: dokumentasi resmi OpenRouter, Provider Routing. Param per model bisa override policy global ini kalau ditaruh di agents.defaults.models.<model ref>.params.provider.

Response caching. Caching respons OpenRouter sifatnya opt-in per model, diaktifkan lewat params.responseCache: true (opsional ditambah responseCacheTtlSeconds) di konfigurasi model terkait. OpenClaw lalu mengirim header X-OpenRouter-Cache: true ke OpenRouter. Fitur ini hanya berlaku di rute openrouter.ai yang terverifikasi, bukan di custom baseUrl — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

Fusion router. OpenRouter Fusion mengirim satu model ref OpenClaw ke beberapa model OpenRouter sekaligus secara paralel, lalu OpenRouter sendiri yang menilai jawaban-jawaban itu dan mengembalikan satu respons final. Karena slug upstream-nya openrouter/fusion, ref model OpenClaw-nya membawa dua lapis namespace sekaligus:

openclaw models set openrouter/openrouter/fusion

Panel model analisis dan model juri Fusion dikonfigurasi lewat params.extraBody pada model itu — field-fieldnya diteruskan langsung ke body request chat-completions OpenRouter. Karena Fusion menjalankan beberapa model paralel plus tahap judge/sintesis, latensinya lebih tinggi daripada request satu model langsung — cocok dipakai untuk jawaban yang butuh kualitas tinggi, bukan use case yang sensitif latensi — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

Cara Verifikasi Setup OpenRouter Sudah Jalan

Setelah login dan (opsional) ganti model, cara tercepat mastiin konfigurasinya jalan adalah kirim satu request lokal lewat command inference tanpa lewat percakapan agent penuh — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter:

openclaw infer model run --local --model openrouter/auto --prompt "Reply with exactly: OPENROUTER_OK" --json

Ganti nilai --model dengan ref model lain (misalnya openrouter/openrouter/fusion) buat tes model spesifik yang baru kamu set lewat openclaw models set. Output JSON yang berisi balasan sesuai prompt berarti kredensial dan model ref-nya sudah nyambung benar ke OpenRouter.

Troubleshooting Umum OpenRouter di OpenClaw

Model yang kamu mau tidak muncul di daftar setelah login. Ini biasanya karena restriksi model yang aktif pas proses login menyembunyikan sebagian katalog OpenRouter — pilih Show all OpenRouter models saat ditanya di akhir proses /login openrouter, atau cek ulang pengaturan restriksi model di Gateway. Kredensial OAuth/API key-nya sendiri tetap tersimpan terlepas dari pilihan restriksi ini — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

Custom baseUrl kehilangan header atribusi dan cache marker. Kalau kamu mengarahkan provider OpenRouter ke base URL proxy lain (bukan https://openrouter.ai/api/v1 langsung), OpenClaw tidak menyuntikkan header atribusi resmi OpenRouter (HTTP-Referer, X-OpenRouter-Title, X-OpenRouter-Categories) maupun marker cache cache_control Anthropic — keduanya cuma aktif di rute openrouter.ai yang terverifikasi langsung. Response caching (responseCache) juga ikut tidak berlaku di jalur custom baseUrl ini — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

Login lewat chat gagal dapat callback di server remote. Sign-in browser di chat memakai alamat HTTPS Tailscale yang dikelola Gateway; kalau alamat itu belum aktif, browser kamu perlu berada di tailnet yang sama atau nyalakan Tailscale Serve dulu sebelum coba lagi. Kalau tetap gagal, pakai jalur CLI (openclaw onboard --auth-choice openrouter-oauth) yang mencetak URL sign-in dan minta redirect URL ditempel manual — sumber: dokumentasi resmi OpenClaw, halaman OpenRouter.

Pertanyaan yang Sering Ditanya

Apa beda openrouter/auto dengan pilih model manual lewat openclaw models set?

openrouter/auto membiarkan OpenRouter sendiri yang memutuskan model mana yang menjawab tiap request (routing otomatis), dan ini yang dipakai sebagai default onboarding. Pilih model manual lewat openclaw models set openrouter/<provider>/<model> mengunci satu model/provider tertentu, cocok kalau kamu butuh konsistensi perilaku model atau mau kontrol harga per request.

Kalau sudah login OAuth, apakah masih bisa pindah ke API key manual, atau sebaliknya?

Bisa. Keduanya disimpan ke profil auth OpenRouter yang sama, jadi jalankan ulang openclaw models auth login --provider openrouter --method api-key (atau --method oauth) kapan saja buat ganti metode atau rotate kredensial, tanpa perlu uninstall atau reset OpenClaw.

Apakah OpenClaw menambah biaya di atas tagihan OpenRouter?

Tidak — OpenClaw hanya meneruskan request ke endpoint resmi OpenRouter pakai API key kamu sendiri, jadi biaya yang muncul murni dari harga model dan markup OpenRouter sendiri. Rincian komponen fee itu (bukan dari sisi OpenClaw) dibahas di artikel biaya asli OpenRouter.

Kenapa request ke openrouter/openrouter/fusion kerasa lebih lambat dari model biasa?

Karena Fusion memang mendesainnya begitu: satu prompt dikirim paralel ke beberapa model analisis, lalu ada tahap judge/sintesis buat menggabungkan jawabannya jadi satu respons final. Latensi tambahan ini konsekuensi dari proses multi-model itu, bukan bug — pakai Fusion untuk jawaban yang butuh kualitas tinggi, bukan use case yang butuh respons cepat.

Model yang disebut dokumentasi (misalnya Kimi K2.6) tidak ada di openrouter.ai/models, kenapa?

Katalog model OpenRouter berubah dari waktu ke waktu seiring provider menambah atau menghentikan model. Tiga baris starter OpenClaw memperkaya katalog publik yang sedang tidak kosong, tapi request live yang gagal akan melapor sebagai kegagalan discovery apa adanya, bukan diam-diam diganti baris starter itu — jadi selalu cek ulang openrouter.ai/models buat slug model terbaru sebelum menguncinya di agents.defaults.model.primary.

Perlu install plugin tambahan buat pakai OpenRouter di OpenClaw?

Tidak. Provider OpenRouter (paket @openclaw/openrouter-provider) sudah dibundel di instalasi OpenClaw secara default — langkah login/onboarding di atas cukup, tanpa instalasi plugin terpisah.

Disclaimer: command, nama field konfigurasi, dan perilaku yang disebut di halaman ini mengikuti dokumentasi resmi OpenClaw versi 2026.9.6, per 12 Oktober 2026, dan bisa berubah mengikuti rilis OpenClaw maupun kebijakan OpenRouter berikutnya. Cek dokumentasi resmi sebelum menerapkan di setup produksi.