OpenRouter

OpenRouter एक एकीकृत API प्रदान करता है, जो एक ही endpoint और API key के पीछे कई models को requests route करता है। यह OpenAI-संगत है, इसलिए अधिकांश OpenAI SDKs base URL बदलने पर काम करते हैं।

शुरू करना

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>

Config उदाहरण

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

Model references

Bundled fallback उदाहरण:

Image generation

OpenRouter image_generate tool को भी back कर सकता है। agents.defaults.imageGenerationModel के अंतर्गत OpenRouter image model का उपयोग करें:

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

OpenClaw image requests को OpenRouter के chat completions image API पर modalities: ["image", "text"] के साथ भेजता है। Gemini image models को supported aspectRatio और resolution hints OpenRouter के image_config के माध्यम से मिलते हैं। धीमे OpenRouter image models के लिए agents.defaults.imageGenerationModel.timeoutMs का उपयोग करें; image_generate tool का per-call timeoutMs parameter फिर भी प्राथमिकता लेता है।

Video generation

OpenRouter अपने asynchronous /videos API के माध्यम से video_generate tool को भी back कर सकता है। agents.defaults.videoGenerationModel के अंतर्गत OpenRouter video model का उपयोग करें:

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

OpenClaw text-to-video और image-to-video jobs OpenRouter को submit करता है, लौटाए गए polling_url को poll करता है, और पूर्ण हुए video को OpenRouter के unsigned_urls या documented job content endpoint से download करता है। Reference images default रूप से first/last frame images के रूप में भेजी जाती हैं; reference_image tag वाली images OpenRouter input references के रूप में भेजी जाती हैं। Bundled google/veo-3.1-fast default वर्तमान supported 4/6/8 second durations, 720P/1080P resolutions, और 16:9/9:16 aspect ratios advertise करता है। Video-to-video OpenRouter के लिए registered नहीं है क्योंकि upstream video generation API फिलहाल text और image references स्वीकार करता है।

Music generation

OpenRouter chat completions audio output के माध्यम से music_generate tool को भी back कर सकता है। agents.defaults.musicGenerationModel के अंतर्गत OpenRouter audio model का उपयोग करें:

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

Bundled OpenRouter music provider default रूप से google/lyria-3-pro-preview का उपयोग करता है और google/lyria-3-clip-preview भी expose करता है। OpenClaw modalities: ["text", "audio"] भेजता है, streaming enable करता है, streamed audio chunks collect करता है, और channel delivery के लिए result को generated media के रूप में save करता है। Reference images shared music_generate image=... parameter के माध्यम से Lyria models के लिए स्वीकार की जाती हैं।

Text-to-speech

OpenRouter को उसके OpenAI-संगत /audio/speech endpoint के माध्यम से TTS provider के रूप में भी उपयोग किया जा सकता है।

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

यदि messages.tts.providers.openrouter.apiKey छोड़ा गया है, तो TTS models.providers.openrouter.apiKey, फिर OPENROUTER_API_KEY को reuse करता है।

Speech-to-text (inbound audio)

OpenRouter shared tools.media.audio path के माध्यम से अपने STT endpoint (/audio/transcriptions) का उपयोग करके inbound voice/audio attachments को transcribe कर सकता है। यह किसी भी channel plugin पर लागू होता है जो inbound voice/audio को media understanding preflight में forward करता है।

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

OpenClaw OpenRouter STT requests को input_audio के अंतर्गत base64 audio के साथ JSON के रूप में भेजता है (OpenRouter STT contract), multipart OpenAI form uploads के रूप में नहीं।

Fusion router

जब आप चाहते हैं कि एक OpenClaw model ref कई OpenRouter models से parallel में पूछे, OpenRouter उनके उत्तरों का judgment करे, और normal OpenRouter provider endpoint के माध्यम से एक अंतिम response return करे, तब OpenRouter Fusion का उपयोग करें। क्योंकि upstream model slug openrouter/fusion है, OpenClaw model ref में OpenClaw provider prefix और upstream OpenRouter namespace दोनों शामिल होते हैं:

openclaw models set openrouter/openrouter/fusion

Fusion के panel और judge को model के params.extraBody के माध्यम से configure करें। वे fields OpenRouter chat-completions request body में forward किए जाते हैं। Fusion OpenRouter OAuth onboarding या API-key onboarding, दोनों के साथ काम करता है; यदि आप OAuth का उपयोग करते हैं, तो नीचे दिए गए example से env.OPENROUTER_API_KEY line हटा दें।

{  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 list parallel panel है, और Fusion plugin config के अंदर model judge model है। Fusion को force करने की कोशिश में normal OpenClaw agent/chat turns में top-level tool_choice को "required" पर set न करें; OpenClaw turns में OpenClaw tool definitions शामिल हो सकती हैं, और top-level required tool choice Fusion router के बजाय उन tools में से किसी एक की मांग कर सकता है। जब यह Fusion plugin config मौजूद होता है, OpenClaw configured analysis models और judge model के साथ sanitized system-prompt note भी जोड़ता है, ताकि agent अपने current Fusion panel के बारे में सवालों का जवाब दे सके। अन्य extraBody fields prompt में copy नहीं किए जाते।

Fusion design के अनुसार धीमा है। OpenRouter वही OpenClaw prompt कई analysis models को भेज सकता है और फिर final judge/synthesis step चला सकता है, इसलिए latency आमतौर पर direct single-model request से अधिक होती है। Fusion का उपयोग deliberate, high-quality answers या escalation paths के लिए करें, इसे latency-sensitive chat के लिए default न बनाएँ। तेज responses के लिए, panel छोटा रखें और तेज analysis और judge models चुनें।

Configured ref को one-shot local model call से test करें:

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

Authentication and headers

OpenRouter पर्दे के पीछे आपकी API key के साथ Bearer token का उपयोग करता है। OpenRouter OAuth एक PKCE login flow है जो OpenRouter API key issue करता है, इसलिए OpenClaw result को manual API-key setup path द्वारा उपयोग किए जाने वाले उसी openrouter:default API-key auth profile के रूप में store करता है।

Existing install के लिए, full onboarding दोबारा चलाए बिना stored OpenRouter key में sign in करें या rotate करें:

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

जब आप OpenRouter पर manually बनाई गई key paste करना चाहते हैं, तब openclaw models auth login --provider openrouter --method api-key का उपयोग करें।

Real OpenRouter requests (https://openrouter.ai/api/v1) पर, OpenClaw OpenRouter के documented app-attribution headers भी जोड़ता है:

Advanced configuration

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

संबंधित