{"id":2260,"date":"2026-10-14T09:10:42","date_gmt":"2026-10-14T02:10:42","guid":{"rendered":"https:\/\/komunitech.com\/blog\/?p=2260"},"modified":"2026-10-14T09:10:42","modified_gmt":"2026-10-14T02:10:42","slug":"cara-setting-openrouter-openclaw-2026","status":"publish","type":"post","link":"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/","title":{"rendered":"Cara Setting API Key OpenRouter di OpenClaw (2026): Onboard, Config, Pilih Model"},"content":{"rendered":"<div style=\"background:#f8fafc;border-left:4px solid #3b82f6;padding:16px 20px;margin:24px 0;border-radius:0 6px 6px 0\">\n<p style=\"margin:0;font-size:15px;line-height:1.6;color:#1e293b\"><strong>TL;DR:<\/strong> Setting API key OpenRouter di OpenClaw ada dua jalur: kirim <code>\/login openrouter<\/code> di chat (atau klik Connect di Control UI) buat OAuth tanpa tempel key manual, atau jalankan <code>openclaw onboard --auth-choice openrouter-api-key<\/code> kalau kamu sudah punya key dari openrouter.ai\/keys. Setelah login tersimpan, model default-nya <code>openrouter\/auto<\/code>; ganti ke model spesifik dengan <code>openclaw models set openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code>, menurut dokumentasi resmi OpenClaw per versi 2026.9.6 (dicek 12 Oktober 2026). Tanpa tempel key manual pun bisa \u2014 OAuth otomatis nyimpen key hasil tukar PKCE ke profil auth yang sama.<\/p>\n<\/div>\n<div style=\"background:#f0f9ff;border-left:4px solid #0284c7;padding:16px 20px;margin:24px 0;border-radius:0 6px 6px 0\">\n<p style=\"margin:0 0 8px;font-size:12px;font-weight:700;letter-spacing:0.05em;text-transform:uppercase;color:#0284c7\">\ud83d\udca1 KEY TAKEAWAY<\/p>\n<ul style=\"margin:0;padding-left:1.2em;font-size:15px;line-height:1.6;color:#0c4a6e\">\n<li style=\"margin-bottom:6px\"><strong>Satu API key, banyak model:<\/strong> OpenRouter jadi satu endpoint OpenAI-compatible yang meneruskan ke puluhan provider model sekaligus.<\/li>\n<li style=\"margin-bottom:6px\"><strong>Dua cara login:<\/strong> OAuth (browser, tanpa copy-paste key) atau API key manual dari openrouter.ai\/keys \u2014 dua-duanya disimpan di profil auth <code>openrouter:default<\/code> yang sama.<\/li>\n<li style=\"margin-bottom:6px\"><strong>Format model ref:<\/strong> <code>openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code>, dengan <code>openrouter\/auto<\/code> sebagai default routing otomatis.<\/li>\n<li style=\"margin-bottom:0\"><strong>Custom <code>baseUrl<\/code> hilangkan header atribusi:<\/strong> kalau provider OpenRouter dialihkan ke proxy lain, OpenClaw tidak lagi menyuntik header <code>HTTP-Referer<\/code>\/<code>X-OpenRouter-Title<\/code> dan marker cache Anthropic.<\/li>\n<\/ul>\n<\/div>\n<p>Kamu sudah install OpenClaw dan sudah (atau belum) punya API key OpenRouter, tapi bingung di mana key itu disetel. Jawaban singkatnya: ketik <code>\/login openrouter<\/code> di chat OpenClaw buat OAuth lewat browser (key dibuatkan otomatis), atau jalankan <code>openclaw onboard --auth-choice openrouter-api-key<\/code> kalau kamu sudah pegang key dari openrouter.ai\/keys \u2014 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.<\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_88 ez-toc-wrap-center counter-hierarchy ez-toc-counter ez-toc-light-blue ez-toc-container-direction\">\n<label for=\"ez-toc-cssicon-toggle-item-6acefef60ecd3\" class=\"ez-toc-cssicon-toggle-label\"><span class=\"ez-toc-cssicon\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/label><input type=\"checkbox\"  id=\"ez-toc-cssicon-toggle-item-6acefef60ecd3\"  aria-label=\"Toggle\" \/><nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Apa_Itu_OpenRouter_dan_Kenapa_Dipakai_di_OpenClaw\" >Apa Itu OpenRouter dan Kenapa Dipakai di OpenClaw<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Cara_Login_OpenRouter_di_OpenClaw_Chat_CLI_OAuth_dan_API_Key\" >Cara Login OpenRouter di OpenClaw: Chat, CLI, OAuth, dan API Key<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Lewat_Chat_login_openrouter\" >Lewat Chat: \/login openrouter<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Lewat_CLI_openclaw_onboard_%E2%80%93auth-choice\" >Lewat CLI: openclaw onboard &#8211;auth-choice<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#OAuth_vs_API_Key_Manual\" >OAuth vs API Key Manual<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Cara_Ganti_atau_Pilih_Model_OpenRouter_di_OpenClaw\" >Cara Ganti atau Pilih Model OpenRouter di OpenClaw<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Contoh_configjson5_Pasang_OPENROUTER_API_KEY_Lewat_File\" >Contoh config.json5: Pasang OPENROUTER_API_KEY Lewat File<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Fitur_Lanjutan_OpenRouter_di_OpenClaw_Provider_Routing_Response_Caching_Fusion\" >Fitur Lanjutan OpenRouter di OpenClaw (Provider Routing, Response Caching, Fusion)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Cara_Verifikasi_Setup_OpenRouter_Sudah_Jalan\" >Cara Verifikasi Setup OpenRouter Sudah Jalan<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Troubleshooting_Umum_OpenRouter_di_OpenClaw\" >Troubleshooting Umum OpenRouter di OpenClaw<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Pertanyaan_yang_Sering_Ditanya\" >Pertanyaan yang Sering Ditanya<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Apa_beda_openrouterauto_dengan_pilih_model_manual_lewat_openclaw_models_set\" >Apa beda openrouter\/auto dengan pilih model manual lewat openclaw models set?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Kalau_sudah_login_OAuth_apakah_masih_bisa_pindah_ke_API_key_manual_atau_sebaliknya\" >Kalau sudah login OAuth, apakah masih bisa pindah ke API key manual, atau sebaliknya?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Apakah_OpenClaw_menambah_biaya_di_atas_tagihan_OpenRouter\" >Apakah OpenClaw menambah biaya di atas tagihan OpenRouter?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-15\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Kenapa_request_ke_openrouteropenrouterfusion_kerasa_lebih_lambat_dari_model_biasa\" >Kenapa request ke openrouter\/openrouter\/fusion kerasa lebih lambat dari model biasa?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-16\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Model_yang_disebut_dokumentasi_misalnya_Kimi_K26_tidak_ada_di_openrouteraimodels_kenapa\" >Model yang disebut dokumentasi (misalnya Kimi K2.6) tidak ada di openrouter.ai\/models, kenapa?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-17\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Perlu_install_plugin_tambahan_buat_pakai_OpenRouter_di_OpenClaw\" >Perlu install plugin tambahan buat pakai OpenRouter di OpenClaw?<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-18\" href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-setting-openrouter-openclaw-2026\/#Referensi\" >Referensi<\/a><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Apa_Itu_OpenRouter_dan_Kenapa_Dipakai_di_OpenClaw\"><\/span>Apa Itu OpenRouter dan Kenapa Dipakai di OpenClaw<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>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 \u2014 <a href=\"https:\/\/en.wikipedia.org\/wiki\/OpenRouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: Wikipedia, entri OpenRouter<\/a>. Dari sisi OpenClaw, OpenRouter diperlakukan sebagai satu provider model yang kompatibel dengan transport <code>openai-completions<\/code> yang sama dipakai provider proxy lain \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<p>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 <code>openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code> yang dijelaskan di bagian ganti model di bawah. Plugin OpenRouter ini sudah dibundel langsung ke OpenClaw sebagai paket <code>@openclaw\/openrouter-provider<\/code> \u2014 tidak perlu instalasi tambahan apa pun \u2014 <a href=\"https:\/\/docs.openclaw.ai\/plugins\/reference\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, referensi plugin OpenRouter<\/a>.<\/p>\n<p>Kalau kamu lagi menimbang OpenRouter dibandingkan opsi gateway AI lain, <a href=\"https:\/\/komunitech.com\/blog\/riset\/openrouter-vs-9router-panduan-memilih-ai-gateway-router-2026\/\">perbandingan OpenRouter vs 9Router sebagai AI gateway\/router<\/a> membahas sisi self-hosted-nya \u2014 tapi jalur yang dibahas di sini adalah setting integrasi native OpenRouter langsung ke OpenClaw, tanpa router pihak ketiga di tengahnya.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Cara_Login_OpenRouter_di_OpenClaw_Chat_CLI_OAuth_dan_API_Key\"><\/span>Cara Login OpenRouter di OpenClaw: Chat, CLI, OAuth, dan API Key<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>OpenClaw menyediakan dua jalur login OpenRouter yang menyimpan hasil ke profil auth yang sama (<code>openrouter:default<\/code>) \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>. Beda cara dapetinnya, sama hasil akhirnya.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Lewat_Chat_login_openrouter\"><\/span>Lewat Chat: \/login openrouter<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Di private chat OpenClaw, kirim <code>\/login openrouter<\/code> atau pilih OpenRouter dari menu <code>\/login<\/code>, lalu pilih <strong>Sign in with OpenRouter<\/strong>. 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 \u2014 kalau restriksi model yang aktif menyembunyikan model OpenRouter, kamu akan ditanya mau <strong>Show all OpenRouter models<\/strong> atau <strong>Keep current restrictions<\/strong>; kredensialnya tetap tersimpan apa pun pilihannya. <code>\/login cancel<\/code> membatalkan proses sign-in yang masih menggantung. Di Control UI, menu yang setara ada di <strong>Settings \u2192 Models \u2192 Connect<\/strong>, lalu pilih model lewat katalog Gateway.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Lewat_CLI_openclaw_onboard_%E2%80%93auth-choice\"><\/span>Lewat CLI: openclaw onboard &#8211;auth-choice<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Buat setup awal dari terminal, dua command onboarding yang tersedia:<\/p>\n<pre><code>openclaw onboard --auth-choice openrouter-oauth<\/code><\/pre>\n<p>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 \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<pre><code>openclaw onboard --auth-choice openrouter-api-key<\/code><\/pre>\n<p>Command ini meminta kamu masukkan API key yang sudah dibuat manual (lihat subbagian berikutnya). Kedua command onboarding ini defaultnya langsung set model ke <code>openrouter\/auto<\/code>.<\/p>\n<p>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:<\/p>\n<pre><code>openclaw models auth login --provider openrouter --method oauth\nopenclaw models auth login --provider openrouter --method api-key<\/code><\/pre>\n<h3><span class=\"ez-toc-section\" id=\"OAuth_vs_API_Key_Manual\"><\/span>OAuth vs API Key Manual<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>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 <code>openclaw onboard --auth-choice openrouter-api-key<\/code> di atas \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>. 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 \u2014 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, <a href=\"https:\/\/komunitech.com\/blog\/tutorial\/cara-membuat-memakai-api-key-openrouter-panduan-2026\/\">panduan lengkap cara membuat API key OpenRouter<\/a> membahasnya sendiri \u2014 bagian ini fokus ke cara pasangnya di OpenClaw, bukan cara bikin key-nya.<\/p>\n<p>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 <code>openclaw models auth login --provider openrouter --method api-key<\/code> dan masukkan key barunya. Command <code>models auth login<\/code> ini memang disediakan dokumentasi OpenClaw khusus buat sign-in ulang atau rotate key tanpa onboarding penuh.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Cara_Ganti_atau_Pilih_Model_OpenRouter_di_OpenClaw\"><\/span>Cara Ganti atau Pilih Model OpenRouter di OpenClaw<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Model ref OpenRouter di OpenClaw mengikuti pola <code>openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code> \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>. Buat ganti model setelah login, command-nya:<\/p>\n<pre><code>openclaw models set openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code><\/pre>\n<p>Beberapa model starter yang sudah dibundel sebagai baris katalog siap pakai (sumber yang sama):<\/p>\n<table style=\"width:100%;border-collapse:collapse;margin:16px 0\">\n<thead>\n<tr style=\"background:#f1f5f9\">\n<th style=\"text-align:left;padding:8px;border:1px solid #e2e8f0\">Model Ref<\/th>\n<th style=\"text-align:left;padding:8px;border:1px solid #e2e8f0\">Keterangan<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"padding:8px;border:1px solid #e2e8f0\"><code>openrouter\/auto<\/code><\/td>\n<td style=\"padding:8px;border:1px solid #e2e8f0\">Routing otomatis OpenRouter, default onboarding<\/td>\n<\/tr>\n<tr>\n<td style=\"padding:8px;border:1px solid #e2e8f0\"><code>openrouter\/moonshotai\/kimi-k2.6<\/code><\/td>\n<td style=\"padding:8px;border:1px solid #e2e8f0\">Kimi K2.6 via MoonshotAI<\/td>\n<\/tr>\n<tr>\n<td style=\"padding:8px;border:1px solid #e2e8f0\"><code>openrouter\/moonshotai\/kimi-k2.5<\/code><\/td>\n<td style=\"padding:8px;border:1px solid #e2e8f0\">Kimi K2.5 via MoonshotAI<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Selain tiga baris starter itu, ref <code>openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code> apa pun \u2014 termasuk <code>openrouter\/openrouter\/fusion<\/code> yang dibahas di bagian fitur lanjutan \u2014 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 <code>supported_parameters<\/code> yang diumumkan OpenRouter sendiri: kalau metadata itu tidak menyebut <code>tools<\/code>, OpenClaw mengirim request tanpa definisi tool.<\/p>\n<p>Kalau budget jadi concern pas milih model, cek dulu <a href=\"https:\/\/komunitech.com\/blog\/riset\/berapa-biaya-asli-openrouter-fee-yang-perlu-kamu-hitung\/\">rincian biaya asli OpenRouter dan fee yang perlu dihitung<\/a> sebelum mengunci satu model berbayar sebagai <code>primary<\/code>. Kalau mau mulai dari yang gratis dulu, <a href=\"https:\/\/komunitech.com\/blog\/tutorial\/model-gratis-openrouter-daftar-lengkap-rate-limit-2026\/\">daftar model gratis OpenRouter beserta rate limit-nya<\/a> bisa jadi titik awal sebelum upgrade ke model berbayar lewat command di atas.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Contoh_configjson5_Pasang_OPENROUTER_API_KEY_Lewat_File\"><\/span>Contoh config.json5: Pasang OPENROUTER_API_KEY Lewat File<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Setup manual lewat file config juga didukung, bukan cuma lewat command onboarding \u2014 polanya taruh API key di <code>env.vars.OPENROUTER_API_KEY<\/code> dan set model default di <code>agents.defaults.model.primary<\/code> \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>:<\/p>\n<pre><code>{\n  env: { vars: { OPENROUTER_API_KEY: \"sk-or-...\" } },\n  agents: {\n    defaults: {\n      model: { primary: \"openrouter\/auto\" },\n    },\n  },\n}<\/code><\/pre>\n<p>Ganti nilai <code>model.primary<\/code> dengan ref model spesifik (misalnya <code>openrouter\/moonshotai\/kimi-k2.6<\/code>) kalau kamu sudah tahu model mana yang mau dipakai terus-terusan. Baris <code>OPENROUTER_API_KEY<\/code> ini hanya dipakai kalau kamu setup manual lewat file \u2014 kalau login lewat OAuth, baris ini bisa dihilangkan karena key-nya sudah tersimpan otomatis di profil auth.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Fitur_Lanjutan_OpenRouter_di_OpenClaw_Provider_Routing_Response_Caching_Fusion\"><\/span>Fitur Lanjutan OpenRouter di OpenClaw (Provider Routing, Response Caching, Fusion)<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Tiga fitur ini opsional \u2014 skip bagian ini kalau setup dasar di atas sudah cukup buat kebutuhanmu.<\/p>\n<p><strong>Provider routing.<\/strong> OpenRouter mendukung objek <code>provider<\/code> buat mengatur provider upstream mana yang dipilih di belakang satu model ref. Di OpenClaw, policy default buat semua request model teks OpenRouter diatur lewat <code>models.providers.openrouter.params.provider<\/code>, dengan field snake_case resmi OpenRouter seperti <code>sort<\/code>, <code>only<\/code>, <code>ignore<\/code>, <code>order<\/code>, <code>allow_fallbacks<\/code>, <code>require_parameters<\/code>, dan <code>data_collection<\/code> \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>; detail tiap field provider routing juga didokumentasikan langsung oleh OpenRouter \u2014 <a href=\"https:\/\/openrouter.ai\/docs\/features\/provider-routing\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenRouter, Provider Routing<\/a>. Param per model bisa override policy global ini kalau ditaruh di <code>agents.defaults.models.&lt;model ref&gt;.params.provider<\/code>.<\/p>\n<p><strong>Response caching.<\/strong> Caching respons OpenRouter sifatnya opt-in per model, diaktifkan lewat <code>params.responseCache: true<\/code> (opsional ditambah <code>responseCacheTtlSeconds<\/code>) di konfigurasi model terkait. OpenClaw lalu mengirim header <code>X-OpenRouter-Cache: true<\/code> ke OpenRouter. Fitur ini hanya berlaku di rute <code>openrouter.ai<\/code> yang terverifikasi, bukan di custom <code>baseUrl<\/code> \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<p><strong>Fusion router.<\/strong> 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 <code>openrouter\/fusion<\/code>, ref model OpenClaw-nya membawa dua lapis namespace sekaligus:<\/p>\n<pre><code>openclaw models set openrouter\/openrouter\/fusion<\/code><\/pre>\n<p>Panel model analisis dan model juri Fusion dikonfigurasi lewat <code>params.extraBody<\/code> pada model itu \u2014 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 \u2014 cocok dipakai untuk jawaban yang butuh kualitas tinggi, bukan use case yang sensitif latensi \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Cara_Verifikasi_Setup_OpenRouter_Sudah_Jalan\"><\/span>Cara Verifikasi Setup OpenRouter Sudah Jalan<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Setelah login dan (opsional) ganti model, cara tercepat mastiin konfigurasinya jalan adalah kirim satu request lokal lewat command inference tanpa lewat percakapan agent penuh \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>:<\/p>\n<pre><code>openclaw infer model run --local --model openrouter\/auto --prompt \"Reply with exactly: OPENROUTER_OK\" --json<\/code><\/pre>\n<p>Ganti nilai <code>--model<\/code> dengan ref model lain (misalnya <code>openrouter\/openrouter\/fusion<\/code>) buat tes model spesifik yang baru kamu set lewat <code>openclaw models set<\/code>. Output JSON yang berisi balasan sesuai prompt berarti kredensial dan model ref-nya sudah nyambung benar ke OpenRouter.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Troubleshooting_Umum_OpenRouter_di_OpenClaw\"><\/span>Troubleshooting Umum OpenRouter di OpenClaw<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><strong>Model yang kamu mau tidak muncul di daftar setelah login.<\/strong> Ini biasanya karena restriksi model yang aktif pas proses login menyembunyikan sebagian katalog OpenRouter \u2014 pilih <strong>Show all OpenRouter models<\/strong> saat ditanya di akhir proses <code>\/login openrouter<\/code>, atau cek ulang pengaturan restriksi model di Gateway. Kredensial OAuth\/API key-nya sendiri tetap tersimpan terlepas dari pilihan restriksi ini \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<p><strong>Custom <code>baseUrl<\/code> kehilangan header atribusi dan cache marker.<\/strong> Kalau kamu mengarahkan provider OpenRouter ke base URL proxy lain (bukan <code>https:\/\/openrouter.ai\/api\/v1<\/code> langsung), OpenClaw tidak menyuntikkan header atribusi resmi OpenRouter (<code>HTTP-Referer<\/code>, <code>X-OpenRouter-Title<\/code>, <code>X-OpenRouter-Categories<\/code>) maupun marker cache <code>cache_control<\/code> Anthropic \u2014 keduanya cuma aktif di rute <code>openrouter.ai<\/code> yang terverifikasi langsung. Response caching (<code>responseCache<\/code>) juga ikut tidak berlaku di jalur custom <code>baseUrl<\/code> ini \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<p><strong>Login lewat chat gagal dapat callback di server remote.<\/strong> 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 (<code>openclaw onboard --auth-choice openrouter-oauth<\/code>) yang mencetak URL sign-in dan minta redirect URL ditempel manual \u2014 <a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">sumber: dokumentasi resmi OpenClaw, halaman OpenRouter<\/a>.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Pertanyaan_yang_Sering_Ditanya\"><\/span>Pertanyaan yang Sering Ditanya<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<h3><span class=\"ez-toc-section\" id=\"Apa_beda_openrouterauto_dengan_pilih_model_manual_lewat_openclaw_models_set\"><\/span>Apa beda openrouter\/auto dengan pilih model manual lewat openclaw models set?<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p><code>openrouter\/auto<\/code> membiarkan OpenRouter sendiri yang memutuskan model mana yang menjawab tiap request (routing otomatis), dan ini yang dipakai sebagai default onboarding. Pilih model manual lewat <code>openclaw models set openrouter\/&lt;provider&gt;\/&lt;model&gt;<\/code> mengunci satu model\/provider tertentu, cocok kalau kamu butuh konsistensi perilaku model atau mau kontrol harga per request.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Kalau_sudah_login_OAuth_apakah_masih_bisa_pindah_ke_API_key_manual_atau_sebaliknya\"><\/span>Kalau sudah login OAuth, apakah masih bisa pindah ke API key manual, atau sebaliknya?<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Bisa. Keduanya disimpan ke profil auth OpenRouter yang sama, jadi jalankan ulang <code>openclaw models auth login --provider openrouter --method api-key<\/code> (atau <code>--method oauth<\/code>) kapan saja buat ganti metode atau rotate kredensial, tanpa perlu uninstall atau reset OpenClaw.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Apakah_OpenClaw_menambah_biaya_di_atas_tagihan_OpenRouter\"><\/span>Apakah OpenClaw menambah biaya di atas tagihan OpenRouter?<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Tidak \u2014 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 <a href=\"https:\/\/komunitech.com\/blog\/riset\/berapa-biaya-asli-openrouter-fee-yang-perlu-kamu-hitung\/\">artikel biaya asli OpenRouter<\/a>.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Kenapa_request_ke_openrouteropenrouterfusion_kerasa_lebih_lambat_dari_model_biasa\"><\/span>Kenapa request ke openrouter\/openrouter\/fusion kerasa lebih lambat dari model biasa?<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>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 \u2014 pakai Fusion untuk jawaban yang butuh kualitas tinggi, bukan use case yang butuh respons cepat.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Model_yang_disebut_dokumentasi_misalnya_Kimi_K26_tidak_ada_di_openrouteraimodels_kenapa\"><\/span>Model yang disebut dokumentasi (misalnya Kimi K2.6) tidak ada di openrouter.ai\/models, kenapa?<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>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 \u2014 jadi selalu cek ulang <a href=\"https:\/\/openrouter.ai\/models\" rel=\"noopener nofollow\" target=\"_blank\">openrouter.ai\/models<\/a> buat slug model terbaru sebelum menguncinya di <code>agents.defaults.model.primary<\/code>.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Perlu_install_plugin_tambahan_buat_pakai_OpenRouter_di_OpenClaw\"><\/span>Perlu install plugin tambahan buat pakai OpenRouter di OpenClaw?<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Tidak. Provider OpenRouter (paket <code>@openclaw\/openrouter-provider<\/code>) sudah dibundel di instalasi OpenClaw secara default \u2014 langkah login\/onboarding di atas cukup, tanpa instalasi plugin terpisah.<\/p>\n<p><em>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.<\/em><\/p>\n<h2><span class=\"ez-toc-section\" id=\"Referensi\"><\/span>Referensi<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li><a href=\"https:\/\/docs.openclaw.ai\/providers\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">Dokumentasi resmi OpenClaw \u2014 Providers: OpenRouter<\/a><\/li>\n<li><a href=\"https:\/\/docs.openclaw.ai\/plugins\/reference\/openrouter\" rel=\"noopener nofollow\" target=\"_blank\">Dokumentasi resmi OpenClaw \u2014 Referensi plugin OpenRouter<\/a><\/li>\n<li><a href=\"https:\/\/docs.openclaw.ai\/concepts\/model-providers\" rel=\"noopener nofollow\" target=\"_blank\">Dokumentasi resmi OpenClaw \u2014 Model selection &amp; provider failover<\/a><\/li>\n<li><a href=\"https:\/\/openrouter.ai\/keys\" rel=\"noopener nofollow\" target=\"_blank\">OpenRouter \u2014 halaman pembuatan API key (openrouter.ai\/keys)<\/a><\/li>\n<li><a href=\"https:\/\/openrouter.ai\/docs\/features\/provider-routing\" rel=\"noopener nofollow\" target=\"_blank\">Dokumentasi resmi OpenRouter \u2014 Provider Routing<\/a><\/li>\n<li><a href=\"https:\/\/en.wikipedia.org\/wiki\/OpenRouter\" rel=\"noopener nofollow\" target=\"_blank\">Wikipedia \u2014 OpenRouter<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>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 &#8211;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\/&lt;provider&gt;\/&lt;model&gt;, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":2262,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[75],"tags":[],"class_list":["post-2260","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorial"],"acf":[],"_links":{"self":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/2260","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/comments?post=2260"}],"version-history":[{"count":5,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/2260\/revisions"}],"predecessor-version":[{"id":2266,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/2260\/revisions\/2266"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media\/2262"}],"wp:attachment":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media?parent=2260"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/categories?post=2260"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/tags?post=2260"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}