Перейти до основного вмісту

​
OpenRouter

OpenRouter надає уніфікований API, який спрямовує запити до багатьох моделей через єдину кінцеву точку та API-ключ. Він сумісний з OpenAI, тож більшість OpenAI SDK працюють, якщо змінити базовий URL.

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

1

Отримайте свій API-ключ

Створіть API-ключ на openrouter.ai/keys.
2

Запустіть онбординг

openclaw onboard --auth-choice openrouter-api-key
3

(Необов’язково) Перейдіть на конкретну модель

Під час онбордингу за замовчуванням використовується openrouter/auto. Пізніше виберіть конкретну модель:
openclaw models set openrouter/<provider>/<model>

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

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

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

Посилання на моделі відповідають шаблону openrouter/<provider>/<model>. Повний список доступних провайдерів і моделей дивіться в /concepts/model-providers.

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

OpenRouter під капотом використовує Bearer-токен з вашим API-ключем. Для реальних запитів OpenRouter (https://openrouter.ai/api/v1) OpenClaw також додає задокументовані заголовки атрибуції застосунку OpenRouter:
HeaderValue
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-agent
Якщо ви перенаправите провайдер OpenRouter на якийсь інший проксі або базовий URL, OpenClaw не додає ці специфічні для OpenRouter заголовки або маркери кешу Anthropic.

​
Додаткові примітки

На перевірених маршрутах OpenRouter посилання на моделі Anthropic зберігають специфічні для OpenRouter маркери Anthropic cache_control, які OpenClaw використовує для кращого повторного використання кешу промптів у блоках системного промпту та промпту розробника.
На підтримуваних маршрутах, відмінних від auto, OpenClaw зіставляє вибраний рівень thinking із проксі-payload reasoning OpenRouter. Непідтримувані підказки моделей і openrouter/auto пропускають цю ін’єкцію reasoning.
OpenRouter усе ще працює через сумісний з OpenAI проксі-шлях, тож нативне формування запитів лише для OpenAI, як-от serviceTier, Responses store, payload сумісності reasoning OpenAI та підказки кешу промптів, не пересилається далі.
Посилання OpenRouter на основі Gemini залишаються на проксі-шляху Gemini: OpenClaw зберігає там санітизацію thought-signature Gemini, але не вмикає нативну перевірку повторного відтворення Gemini або bootstrap-перезаписи.
Якщо ви передаєте маршрутизацію провайдера OpenRouter у параметрах моделі, OpenClaw пересилає її як метадані маршрутизації OpenRouter до запуску спільних обгорток потоку.

​
Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки перемикання у разі збою.

Довідник із конфігурації

Повний довідник з конфігурації для агентів, моделей і провайдерів.