OpenRouter

OpenRouter надає уніфікований API, який маршрутизує запити до багатьох моделей за однією кінцевою точкою й API-ключем. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють після зміни базової 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>

Приклад конфігурації

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

Посилання на моделі

Приклади вбудованих fallback-варіантів:

Генерація зображень

OpenRouter також може забезпечувати роботу інструмента image_generate. Використовуйте модель зображень OpenRouter у 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 надсилає запити зображень до image API chat completions OpenRouter з modalities: ["image", "text"]. Моделі зображень Gemini отримують підтримувані підказки aspectRatio і resolution через image_config OpenRouter. Використовуйте agents.defaults.imageGenerationModel.timeoutMs для повільніших моделей зображень OpenRouter; параметр timeoutMs для окремого виклику інструмента image_generate усе одно має пріоритет.

Генерація відео

OpenRouter також може забезпечувати роботу інструмента video_generate через свій асинхронний API /videos. Використовуйте відеомодель OpenRouter у agents.defaults.videoGenerationModel:

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

OpenClaw надсилає завдання text-to-video та image-to-video до OpenRouter, опитує повернений polling_url і завантажує завершене відео з unsigned_urls OpenRouter або з документованої кінцевої точки вмісту завдання. Еталонні зображення типово надсилаються як зображення першого/останнього кадру; зображення, позначені reference_image, надсилаються як вхідні референси OpenRouter. Вбудований стандартний варіант google/veo-3.1-fast оголошує поточно підтримувані тривалості 4/6/8 секунд, роздільні здатності 720P/1080P і співвідношення сторін 16:9/9:16. Video-to-video не зареєстровано для OpenRouter, оскільки upstream API генерації відео наразі приймає текст і референси зображень.

Генерація музики

OpenRouter також може забезпечувати роботу інструмента music_generate через audio output chat completions. Використовуйте аудіомодель OpenRouter у agents.defaults.musicGenerationModel:

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

Вбудований музичний провайдер OpenRouter типово використовує google/lyria-3-pro-preview і також надає google/lyria-3-clip-preview. OpenClaw надсилає modalities: ["text", "audio"], вмикає потокове передавання, збирає потокові аудіофрагменти й зберігає результат як згенероване медіа для доставки каналом. Еталонні зображення приймаються для моделей Lyria через спільний параметр music_generate image=....

Text-to-speech

OpenRouter також можна використовувати як TTS-провайдера через його сумісну з OpenAI кінцеву точку /audio/speech.

{  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.

Speech-to-text (вхідне аудіо)

OpenRouter може транскрибувати вхідні голосові/аудіовкладення через спільний шлях tools.media.audio, використовуючи свою STT-кінцеву точку (/audio/transcriptions). Це застосовується до будь-якого плагіна каналу, який передає вхідний голос/аудіо до попередньої перевірки розуміння медіа.

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

OpenClaw надсилає STT-запити OpenRouter як JSON із base64-аудіо в input_audio (контракт OpenRouter STT), а не як multipart OpenAI form uploads.

Маршрутизатор Fusion

Використовуйте OpenRouter Fusion, коли потрібно, щоб одне посилання на модель OpenClaw зверталося до кількох моделей OpenRouter паралельно, OpenRouter оцінював їхні відповіді та повертав одну фінальну відповідь через звичайну кінцеву точку провайдера OpenRouter. Оскільки upstream model slug — openrouter/fusion, посилання на модель OpenClaw містить і префікс провайдера OpenClaw, і upstream namespace OpenRouter:

openclaw models set openrouter/openrouter/fusion

Налаштуйте панель і модель-суддю Fusion через params.extraBody моделі. Ці поля передаються в тіло запиту chat-completions OpenRouter. Fusion працює як з OAuth onboarding OpenRouter, так і з API-key onboarding; якщо ви використовуєте OAuth, пропустіть рядок env.OPENROUTER_API_KEY у прикладі нижче.

{  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 — це паралельна панель, а model у конфігурації плагіна Fusion — модель-суддя. Не встановлюйте tool_choice верхнього рівня в "required" у звичайних ходах агента/чату OpenClaw, щоб спробувати примусово використати Fusion; ходи OpenClaw можуть містити визначення інструментів OpenClaw, а обов’язковий вибір інструмента верхнього рівня може вимагати один із цих інструментів замість маршрутизатора Fusion. Коли ця конфігурація плагіна Fusion присутня, OpenClaw також додає санітизовану примітку системного prompt із налаштованими моделями аналізу й моделлю-суддею, щоб агент міг відповідати на запитання про свою поточну панель Fusion. Інші поля extraBody не копіюються в prompt.

Fusion навмисно повільніший. OpenRouter може надіслати той самий prompt OpenClaw до кількох моделей аналізу, а потім виконати фінальний етап оцінювання/синтезу, тому затримка зазвичай вища, ніж у прямому запиті до однієї моделі. Використовуйте Fusion для обдуманих, високоякісних відповідей або шляхів ескалації, а не як типовий варіант для чату, чутливого до затримки. Для швидших відповідей тримайте панель малою й вибирайте швидші моделі аналізу та судді.

Перевірте налаштоване посилання одноразовим локальним викликом моделі:

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

Автентифікація та заголовки

OpenRouter під капотом використовує Bearer token із вашим API-ключем. OpenRouter OAuth — це потік входу PKCE, який видає API-ключ OpenRouter, тому OpenClaw зберігає результат як той самий профіль автентифікації API-ключа openrouter:default, що використовується ручним шляхом налаштування API-ключа.

Для наявної інсталяції увійдіть або змініть збережений ключ OpenRouter без повторного запуску повного onboarding:

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

Використовуйте openclaw models auth login --provider openrouter --method api-key, коли потрібно вставити ключ, який ви створили вручну в OpenRouter.

У реальних запитах OpenRouter (https://openrouter.ai/api/v1) OpenClaw також додає документовані заголовки OpenRouter для attribution застосунку:

Розширена конфігурація

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

Пов'язане