OpenRouter

OpenRouter menyediakan API terpadu yang merutekan permintaan ke banyak model di balik satu endpoint dan kunci API. API ini kompatibel dengan OpenAI, sehingga sebagian besar SDK OpenAI berfungsi dengan mengganti URL dasar.

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

Contoh fallback bawaan:

Pembuatan gambar

OpenRouter juga dapat mendukung alat image_generate. Gunakan 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 chat completions OpenRouter dengan modalities: ["image", "text"]. Model gambar Gemini menerima petunjuk aspectRatio dan resolution yang didukung melalui image_config OpenRouter. Gunakan agents.defaults.imageGenerationModel.timeoutMs untuk model gambar OpenRouter yang lebih lambat; parameter timeoutMs per panggilan alat image_generate tetap berlaku lebih dulu.

Pembuatan video

OpenRouter juga dapat mendukung alat video_generate melalui API /videos asinkronnya. Gunakan 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 ke OpenRouter, melakukan polling pada polling_url yang dikembalikan, dan mengunduh video yang sudah selesai dari unsigned_urls OpenRouter atau endpoint konten pekerjaan yang terdokumentasi. Gambar referensi dikirim sebagai gambar frame pertama/terakhir secara default; gambar yang diberi tag reference_image dikirim sebagai referensi input OpenRouter. Default bawaan google/veo-3.1-fast mengiklankan durasi 4/6/8 detik yang saat ini didukung, resolusi 720P/1080P, dan rasio aspek 16:9/9:16. Video-ke-video tidak didaftarkan untuk OpenRouter karena API pembuatan video upstream saat ini menerima referensi teks dan gambar.

Pembuatan musik

OpenRouter juga dapat mendukung alat music_generate melalui output audio chat completions. Gunakan 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 default dan juga mengekspos google/lyria-3-clip-preview. OpenClaw mengirim modalities: ["text", "audio"], mengaktifkan streaming, mengumpulkan potongan audio yang dialirkan, dan menyimpan hasilnya sebagai media yang dihasilkan untuk pengiriman channel. Gambar referensi diterima untuk model Lyria melalui parameter bersama music_generate image=....

Teks-ke-ucapan

OpenRouter juga dapat digunakan 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 dihilangkan, TTS menggunakan kembali models.providers.openrouter.apiKey, lalu OPENROUTER_API_KEY.

Ucapan-ke-teks (audio masuk)

OpenRouter dapat mentranskripsikan lampiran suara/audio yang masuk melalui jalur tools.media.audio bersama menggunakan endpoint STT-nya (/audio/transcriptions). Ini berlaku untuk Plugin channel apa pun yang meneruskan suara/audio masuk ke prapemeriksaan 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

Gunakan OpenRouter Fusion saat Anda ingin satu ref model OpenClaw meminta beberapa model OpenRouter secara paralel, membuat OpenRouter menilai jawaban mereka, dan mengembalikan satu respons akhir melalui endpoint penyedia OpenRouter normal. Karena slug model upstream adalah openrouter/fusion, ref model OpenClaw menyertakan prefiks penyedia OpenClaw dan namespace OpenRouter upstream:

openclaw models set openrouter/openrouter/fusion

Konfigurasikan panel dan penilai Fusion melalui params.extraBody model. Field tersebut diteruskan ke body permintaan chat-completions OpenRouter. Fusion berfungsi dengan onboarding OAuth OpenRouter atau onboarding kunci API; jika Anda menggunakan OAuth, hilangkan baris env.OPENROUTER_API_KEY dari contoh di bawah.

{  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",                },              ],            },          },        },      },    },  },}

Daftar analysis_models adalah panel paralel, dan model di dalam konfigurasi Plugin Fusion adalah model penilai. Jangan tetapkan tool_choice tingkat atas ke "required" dalam giliran agen/chat OpenClaw normal untuk mencoba memaksa Fusion; giliran OpenClaw dapat menyertakan definisi alat OpenClaw, dan pilihan alat wajib tingkat atas dapat mewajibkan salah satu alat tersebut, bukan router Fusion. Saat konfigurasi Plugin Fusion ini ada, OpenClaw juga menambahkan catatan system-prompt yang disanitasi dengan model analisis dan model penilai yang dikonfigurasi agar agen dapat menjawab pertanyaan tentang panel Fusion saat ini. Field extraBody lainnya tidak disalin ke prompt.

Fusion sengaja dirancang lebih lambat. OpenRouter dapat mengirim prompt OpenClaw yang sama ke beberapa model analisis lalu menjalankan langkah penilaian/sintesis akhir, sehingga latensi biasanya lebih tinggi daripada permintaan langsung ke satu model. Gunakan Fusion untuk jawaban yang deliberatif dan berkualitas tinggi atau jalur eskalasi, bukan sebagai default untuk chat yang sensitif terhadap latensi. Untuk respons yang lebih cepat, pertahankan panel tetap kecil dan pilih model analisis dan penilai yang lebih cepat.

Uji ref yang dikonfigurasi dengan satu panggilan model lokal sekali jalan:

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

Autentikasi dan header

OpenRouter menggunakan token Bearer dengan kunci API Anda di balik layar. OAuth OpenRouter adalah alur login PKCE yang menerbitkan kunci API OpenRouter, sehingga OpenClaw menyimpan hasilnya sebagai profil autentikasi kunci API openrouter:default yang sama dengan yang digunakan oleh jalur penyiapan kunci API manual.

Untuk instalasi yang sudah ada, masuk atau rotasi kunci OpenRouter tersimpan tanpa menjalankan ulang onboarding penuh:

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

Gunakan openclaw models auth login --provider openrouter --method api-key saat Anda ingin menempelkan kunci yang Anda buat secara manual di OpenRouter.

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

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