OpenRouter

OpenRouter спрямовує запити до багатьох моделей через єдиний API та один ключ. Він сумісний з OpenAI, тому OpenClaw взаємодіє з ним через той самий транспорт у стилі openai-completions, який використовується для інших проксі-провайдерів.

Початок роботи

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

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

Вбудовані резервні моделі, що використовуються, коли динамічне виявлення каталогу недоступне:

Будь-яке інше посилання openrouter/<provider>/<model>, зокрема openrouter/openrouter/fusion (див. маршрутизатор Fusion), динамічно зіставляється з актуальним каталогом моделей OpenRouter.

Генерування зображень

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 надсилає запити на зображення до API зображень chat-completions OpenRouter із параметром modalities: ["image", "text"]. Моделі Gemini для зображень додатково отримують підказки aspectRatio і resolution через image_config OpenRouter; інші моделі зображень їх не отримують. Для повільніших моделей використовуйте agents.defaults.imageGenerationModel.timeoutMs; значення 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 надсилає завдання перетворення тексту на відео та зображення на відео, опитує повернену polling_url і завантажує готове відео з unsigned_urls OpenRouter або кінцевої точки вмісту завдання. Еталонні зображення за замовчуванням використовуються як перший або останній кадр; натомість зображення з позначкою reference_image надсилаються як вхідні еталони. Вбудована модель google/veo-3.1-fast за замовчуванням підтримує тривалість 4/6/8 секунд, роздільну здатність 720P/1080P і співвідношення сторін 16:9/9:16. Перетворення відео на відео не підтримується: вищерівневий API приймає лише текстові та графічні еталони.

Генерування музики

OpenRouter може забезпечувати роботу інструмента music_generate через аудіовихід 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=.... Обсяг потокового аудіо, збереженого транскрипту та похідної оболонки подій SSE обмежується параметром agents.defaults.mediaMaxMb (обмеження аудіо за замовчуванням становить 16 МБ).

Перетворення тексту на мовлення

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.

Перетворення мовлення на текст (вхідне аудіо)

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 (контракт STT OpenRouter), а не як передавання форм OpenAI у форматі multipart.

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

OpenRouter Fusion паралельно надсилає одне посилання на модель OpenClaw кільком моделям OpenRouter, доручає OpenRouter оцінити їхні відповіді та повертає одну остаточну відповідь через звичайний кінцевий пункт OpenRouter. Ідентифікатор висхідної моделі — openrouter/fusion, тому посилання на модель OpenClaw містить і префікс провайдера OpenClaw, і простір імен висхідного OpenRouter:

openclaw models set openrouter/openrouter/fusion

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

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

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

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

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

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

Щоб увійти або замінити збережений ключ у наявному встановленні без повторного повного початкового налаштування:

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

До перевірених запитів OpenRouter (https://openrouter.ai/api/v1) OpenClaw додає документовані OpenRouter заголовки атрибуції застосунку:

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

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

Пов’язане