Вопрос

OpenRouter в OpenClaw: как подключить и что меняется

Подключите OpenRouter через OAuth или API-ключ, проверьте видимость моделей и поймите, чем он отличается от прямых провайдеров.

· 4 мин чтения

Коротко

  • OpenRouter — единый OpenAI-совместимый эндпоинт: один ключ и доступ к моделям разных лабораторий через openrouter/<provider>/<model>.
  • Авторизуйтесь через /login openrouter в чате или через openclaw onboard с флагом --auth-choice openrouter-oauth или --auth-choice openrouter-api-key.
  • После входа выберите модель командой openclaw models set openrouter/<provider>/<model> или оставьте openrouter/auto. Добавление ключа не меняет текущий основной реф.
  • Реф openrouter/<provider>/<model> разрешается по живому каталогу OpenRouter, а openrouter/auto и две модели Kimi идут в стартовом наборе.

Сверено с документацией OpenClaw 2026.10.1, 11 октября 2026.

OpenRouter подключается к OpenClaw как один из провайдеров и использует тот же OpenAI-совместимый транспорт, что и остальные прокси. С его помощью OpenClaw обращается к моделям разных лабораторий через один ключ и один URL. Ниже — как завести ключ, как проверить, что модели появились у агента, и в чём разница с прямыми провайдерами.

Два способа завести ключ

В личном чате с ботом отправьте /login openrouter и выберите Sign in with OpenRouter. После подтверждения в браузере OpenClaw получит колбэк и сохранит учётные данные. Команда /login cancel отменяет ожидающий вход. После входа модель по умолчанию не выбирается: если текущие ограничения скрывают модели OpenRouter, выберите Show all OpenRouter models или оставьте Keep current restrictions — ключ сохранится в обоих случаях.

Тот же сценарий даёт меню Settings → Models → Connect в Control UI. После записи ключа модель выбирают через меню моделей в каталоге Gateway. Вход из чата через браузер идёт через управляемый HTTPS-адрес Gateway (Tailscale Serve), поэтому браузер должен видеть тот же tailnet; если такого адреса нет, включите Serve или используйте CLI-флоу. Control UI принимает возврат автоматически на этом адресе или при открытии на локальном loopback-адресе Gateway, на остальных адресах ответный URL вставляют вручную.

CLI-флоу проведёт через PKCE и сохранит ключ. На удалённых хостах без браузера OpenClaw напечатает URL для входа и попросит вставить ответный URL после подтверждения в браузере.

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

Минимальный конфиг

После входа ключ лежит в хранилище учётных данных. Конфиг сводится к выбору основной модели. Ключ можно хранить и в окружении.

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

Проверка видимости моделей

  1. Запустите openclaw models list и найдите строки с префиксом openrouter/. Должны появиться openrouter/auto и модели стартового набора (openrouter/moonshotai/kimi-k2.6, openrouter/moonshotai/kimi-k2.5). Если живой каталог не загрузился, стартовые строки не подставляются — OpenClaw покажет ошибку discovery.
  2. Любую другую модель выберите командой openclaw models set openrouter/<provider>/<model>. Рефы разрешаются по живому каталогу OpenRouter, а не из вшитого списка.
  3. Если в Settings → Models нужные модели не появились, нажмите Test connection на карточке OpenRouter. Проба делает реальный запрос и покажет задержку или категорию ошибки: аутентификация, лимит, биллинг, тайм-аут или ошибка ответа.
  4. Если в списке supported_parameters модели нет tools, OpenClaw отправляет запрос без определений инструментов и выбора инструмента.

Частые ошибки

  • После openclaw onboard --auth-choice openrouter-api-key модели в Control UI не появились: ключ сохранён, но модели не видны. Если их скрывают ограничения моделей, выберите Show all OpenRouter models в вопросе после входа; иначе нажмите Refresh в Settings → Models или выполните openclaw models list --provider openrouter --refresh.
  • Реф модели скопирован из чужого примера, но в Models его нет. Проверьте форму: должен быть openrouter/<provider>/<model>, как в каталоге. Любой реф сверх стартового набора разрешается по живому каталогу OpenRouter.
  • Агент не вызывает инструменты через OpenRouter. Откройте реф модели на openrouter.ai и посмотрите supported_parameters: если tools там нет, OpenClaw отправляет запрос без определений инструментов и выбора инструмента.
  • Хотели сменить основную модель, а повторный вход только обновил ключ. openclaw configure и openclaw models auth login --provider openrouter сохраняют текущий agents.defaults.model.primary. Чтобы переключиться, выполните openclaw models set openrouter/<provider>/<model> или войдите с флагом --set-default.
  • Браузер на удалённой машине не открывает страницу входа. Включите Tailscale Serve и откройте управляемый HTTPS-адрес Gateway, либо пройдите флоу через CLI openclaw onboard --auth-choice openrouter-oauth и вставьте ответный URL после подтверждения.