Langsung ke konten utama

​
OpenRouter

OpenRouter menyediakan API terpadu yang merutekan permintaan ke banyak model di balik satu endpoint dan kunci API. OpenRouter kompatibel dengan OpenAI, sehingga sebagian besar SDK OpenAI dapat digunakan hanya dengan mengganti base URL.

​
Memulai

1

Dapatkan kunci API Anda

Buat kunci API di openrouter.ai/keys.
2

Jalankan onboarding

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

(Opsional) Beralih ke model tertentu

Onboarding secara default menggunakan openrouter/auto. Pilih model konkret nanti:
openclaw models set openrouter/<provider>/<model>

​
Contoh config

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

​
Referensi model

Ref model mengikuti pola openrouter/<provider>/<model>. Untuk daftar lengkap provider dan model yang tersedia, lihat /concepts/model-providers.

​
Auth dan header

OpenRouter menggunakan token Bearer dengan kunci API Anda di balik layar. Pada permintaan OpenRouter nyata (https://openrouter.ai/api/v1), OpenClaw juga menambahkan header atribusi aplikasi OpenRouter yang terdokumentasi:
HeaderNilai
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-agent
Jika Anda mengarahkan ulang provider OpenRouter ke proxy atau base URL lain, OpenClaw tidak menyisipkan header khusus OpenRouter tersebut atau penanda cache Anthropic.

​
Catatan lanjutan

Pada rute OpenRouter yang terverifikasi, ref model Anthropic mempertahankan penanda cache_control Anthropic khusus OpenRouter yang digunakan OpenClaw untuk pemakaian ulang prompt-cache yang lebih baik pada blok prompt system/developer.
Pada rute non-auto yang didukung, OpenClaw memetakan level thinking yang dipilih ke payload reasoning proxy OpenRouter. Petunjuk model yang tidak didukung dan openrouter/auto melewati penyisipan reasoning tersebut.
OpenRouter tetap berjalan melalui jalur kompatibel OpenAI bergaya proxy, sehingga pembentukan permintaan khusus OpenAI native seperti serviceTier, store pada Responses, payload kompatibilitas reasoning OpenAI, dan petunjuk prompt-cache tidak diteruskan.
Ref OpenRouter berbasis Gemini tetap berada di jalur proxy-Gemini: OpenClaw mempertahankan sanitasi thought-signature Gemini di sana, tetapi tidak mengaktifkan validasi replay Gemini native atau penulisan ulang bootstrap.
Jika Anda meneruskan perutean provider OpenRouter di bawah parameter model, OpenClaw akan meneruskannya sebagai metadata perutean OpenRouter sebelum wrapper stream bersama dijalankan.

​
Terkait

Pemilihan model

Memilih provider, ref model, dan perilaku failover.

Referensi konfigurasi

Referensi config lengkap untuk agen, model, dan provider.