OpenRouter

OpenRouter merutekan permintaan ke banyak model di balik satu API dan satu kunci. OpenRouter kompatibel dengan OpenAI, sehingga OpenClaw berkomunikasi dengannya melalui transport bergaya openai-completions yang sama seperti yang digunakan untuk penyedia proksi lainnya.

Memulai

openclaw onboard --auth-choice openrouter-oauth

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

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

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

Contoh konfigurasi

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

Referensi model

Model fallback bawaan, yang digunakan ketika penemuan katalog langsung tidak tersedia:

Referensi openrouter/<provider>/<model> lainnya, termasuk openrouter/openrouter/fusion (lihat Perute Fusion), diselesaikan secara dinamis terhadap katalog model langsung OpenRouter.

Pembuatan gambar

OpenRouter dapat mendukung alat image_generate. Tetapkan model gambar OpenRouter di bawah agents.defaults.imageGenerationModel:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",        timeoutMs: 180_000,      },    },  },}

OpenClaw mengirim permintaan gambar ke API gambar penyelesaian obrolan OpenRouter dengan modalities: ["image", "text"]. Model gambar Gemini juga menerima petunjuk aspectRatio dan resolution melalui image_config OpenRouter; model gambar lainnya tidak. Gunakan agents.defaults.imageGenerationModel.timeoutMs untuk model yang lebih lambat; timeoutMs per panggilan milik alat image_generate tetap diutamakan.

Pembuatan video

OpenRouter dapat mendukung alat video_generate melalui API asinkron /videos. Tetapkan model video OpenRouter di bawah agents.defaults.videoGenerationModel:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      videoGenerationModel: {        primary: "openrouter/google/veo-3.1-fast",      },    },  },}

OpenClaw mengirim pekerjaan teks-ke-video dan gambar-ke-video, melakukan polling pada polling_url yang dikembalikan, dan mengunduh video yang telah selesai dari unsigned_urls OpenRouter atau titik akhir konten pekerjaan. Gambar referensi secara bawaan digunakan sebagai gambar bingkai pertama/terakhir; gambar yang diberi tag reference_image dikirim sebagai referensi masukan. Model bawaan google/veo-3.1-fast mendukung durasi 4/6/8 detik, resolusi 720P/1080P, dan rasio aspek 16:9/9:16. Video-ke-video tidak didukung: API hulu hanya menerima referensi teks dan gambar.

Pembuatan musik

OpenRouter dapat mendukung alat music_generate melalui keluaran audio penyelesaian obrolan. Tetapkan model audio OpenRouter di bawah agents.defaults.musicGenerationModel:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      musicGenerationModel: {        primary: "openrouter/google/lyria-3-pro-preview",        timeoutMs: 180_000,      },    },  },}

Penyedia musik OpenRouter bawaan menggunakan google/lyria-3-pro-preview secara bawaan dan juga menyediakan google/lyria-3-clip-preview. OpenClaw mengirim modalities: ["text", "audio"], mengalirkan respons, mengumpulkan potongan audio, dan menyimpan hasilnya sebagai media yang dihasilkan untuk dikirimkan melalui saluran. Model Lyria menerima satu gambar referensi melalui parameter bersama music_generate image=.... Audio streaming, penyimpanan transkrip, dan amplop peristiwa SSE yang dihasilkan dibatasi oleh agents.defaults.mediaMaxMb (batas audio bawaan adalah 16 MB).

Teks-ke-ucapan

OpenRouter dapat bertindak sebagai penyedia TTS melalui endpoint /audio/speech yang kompatibel dengan OpenAI.

{  messages: {    tts: {      auto: "always",      provider: "openrouter",      providers: {        openrouter: {          model: "hexgrad/kokoro-82m",          speakerVoice: "af_alloy",          responseFormat: "mp3",        },      },    },  },}

Jika messages.tts.providers.openrouter.apiKey tidak dicantumkan, TTS akan beralih menggunakan models.providers.openrouter.apiKey, lalu OPENROUTER_API_KEY.

Ucapan ke teks (audio masuk)

OpenRouter dapat mentranskripsikan lampiran suara/audio yang masuk melalui jalur bersama tools.media.audio, menggunakan endpoint STT-nya (/audio/transcriptions). Hal ini berlaku untuk setiap plugin kanal yang meneruskan suara/audio masuk ke pemeriksaan awal pemahaman media.

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],      },    },  },}

OpenClaw mengirim permintaan STT OpenRouter sebagai JSON dengan audio base64 di bawah input_audio (kontrak STT OpenRouter), bukan sebagai unggahan formulir OpenAI multipart.

Router Fusion

OpenRouter Fusion mengirim satu referensi model OpenClaw ke beberapa model OpenRouter secara paralel, meminta OpenRouter menilai jawaban mereka, dan mengembalikan satu respons akhir melalui endpoint OpenRouter biasa. Slug model upstream adalah openrouter/fusion, sehingga referensi model OpenClaw membawa prefiks penyedia OpenClaw dan namespace OpenRouter upstream:

openclaw models set openrouter/openrouter/fusion

Konfigurasikan panel dan penilai Fusion melalui params.extraBody milik model; bidang tersebut diteruskan langsung ke isi permintaan penyelesaian percakapan OpenRouter. Fusion berfungsi dengan orientasi OAuth maupun kunci API; jika Anda menggunakan OAuth, hilangkan baris env.OPENROUTER_API_KEY di bawah ini.

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      model: { primary: "openrouter/openrouter/fusion" },      models: {        "openrouter/openrouter/fusion": {          params: {            extraBody: {              plugins: [                {                  id: "fusion",                  analysis_models: [                    "google/gemini-3.5-flash",                    "moonshotai/kimi-k2.6",                    "deepseek/deepseek-v4-pro",                  ],                  model: "google/gemini-3.5-flash",                },              ],            },          },        },      },    },  },}

analysis_models adalah panel paralel; model di dalam konfigurasi plugin Fusion adalah model penilai. Jangan atur tool_choice tingkat atas menjadi "required" dalam giliran agen/percakapan biasa untuk mencoba memaksa Fusion: giliran OpenClaw dapat menyertakan definisi alatnya sendiri, dan pilihan alat wajib tingkat atas mungkin memilih salah satu alat tersebut alih-alih router Fusion. Saat konfigurasi plugin Fusion ini tersedia, OpenClaw menambahkan catatan perintah sistem yang telah disanitasi dan mencantumkan model analisis serta model penilai yang dikonfigurasi, sehingga agen dapat menjawab pertanyaan tentang panel Fusion miliknya sendiri. Bidang extraBody lainnya tidak disalin ke dalam perintah.

Fusion sengaja dirancang lebih lambat: OpenRouter menyebarkan perintah ke beberapa model analisis, lalu menjalankan langkah penilaian/sintesis, sehingga latensinya lebih tinggi daripada permintaan langsung ke satu model. Gunakan untuk jawaban yang dipertimbangkan dengan matang dan berkualitas tinggi atau jalur eskalasi, bukan sebagai nilai bawaan yang peka terhadap latensi. Pertahankan ukuran panel tetap kecil dan pilih model analisis/penilai yang lebih cepat untuk memperoleh respons lebih cepat.

Uji referensi yang telah dikonfigurasi dengan satu panggilan lokal:

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Reply with exactly: FUSION_OK" \  --json

Autentikasi dan header

OpenRouter menggunakan token Bearer dari kunci API Anda. OAuth OpenRouter adalah alur masuk PKCE yang menerbitkan kunci API OpenRouter, sehingga OpenClaw menyimpan hasilnya dalam profil autentikasi kunci API openrouter:default yang sama dengan yang digunakan oleh penyiapan kunci API manual.

Untuk masuk atau merotasi kunci yang tersimpan pada instalasi yang sudah ada tanpa menjalankan ulang seluruh orientasi:

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

Pada permintaan OpenRouter yang terverifikasi (https://openrouter.ai/api/v1), OpenClaw menambahkan header atribusi aplikasi OpenRouter yang terdokumentasi:

Konfigurasi lanjutan

{  agents: {    defaults: {      models: {        "openrouter/auto": {          params: {            responseCache: true,            responseCacheTtlSeconds: 300,          },        },      },    },  },}

{  models: {    providers: {      openrouter: {        params: {          provider: {            sort: "latency",            require_parameters: true,            data_collection: "deny",          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openrouter/anthropic/claude-sonnet-4-6": {          params: {            provider: {              order: ["anthropic"],              allow_fallbacks: false,            },          },        },      },    },  },}

Terkait