OpenRouter

OpenRouter предоставляет унифицированный API, который маршрутизирует запросы ко множеству моделей за одним endpoint и ключом API. Он совместим с OpenAI, поэтому большинство SDK OpenAI работают после смены базового 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" },    },  },}

Идентификаторы моделей

Встроенные резервные примеры:

Генерация изображений

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 для более медленных моделей изображений 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 или документированного endpoint содержимого задания. Эталонные изображения по умолчанию отправляются как изображения первого/последнего кадра; изображения с тегом 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 через аудиовывод 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 endpoint /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 endpoint (/audio/transcriptions). Это применяется к любому channel Plugin, который передает входящий голос/аудио в предварительную обработку понимания медиа.

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

OpenClaw отправляет STT-запросы OpenRouter как JSON с аудио base64 в input_audio (контракт STT OpenRouter), а не как multipart-загрузки форм OpenAI.

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

Используйте OpenRouter Fusion, когда хотите, чтобы один идентификатор модели OpenClaw запрашивал несколько моделей OpenRouter параллельно, OpenRouter оценивал их ответы и возвращал единый финальный ответ через обычный endpoint провайдера OpenRouter. Поскольку upstream slug модели — openrouter/fusion, идентификатор модели OpenClaw включает и префикс провайдера OpenClaw, и upstream namespace OpenRouter:

openclaw models set openrouter/openrouter/fusion

Настройте панель и судью Fusion через params.extraBody модели. Эти поля передаются в тело запроса chat-completions OpenRouter. Fusion работает как с OAuth-онбордингом OpenRouter, так и с онбордингом по ключу 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 внутри конфигурации Plugin Fusion — модель-судья. Не задавайте верхнеуровневый tool_choice как "required" в обычных agent/chat-ходах OpenClaw, пытаясь принудительно включить Fusion; ходы OpenClaw могут включать определения инструментов OpenClaw, и верхнеуровневый обязательный выбор инструмента может потребовать один из этих инструментов вместо маршрутизатора Fusion. Когда эта конфигурация Plugin Fusion присутствует, OpenClaw также добавляет очищенную заметку в system 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-токен с вашим ключом API. OpenRouter OAuth — это поток входа PKCE, который выдает ключ API OpenRouter, поэтому OpenClaw сохраняет результат как тот же профиль аутентификации ключа API openrouter:default, который используется путем ручной настройки ключа API.

Для существующей установки войдите или замените сохраненный ключ OpenRouter без повторного полного онбординга:

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 для атрибуции приложения:

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

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

Связанные материалы