> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# ClawRouter
ClawRouter дает OpenClaw один ключ с политически ограниченной областью действия для нескольких вышестоящих поставщиков моделей. Встроенный Plugin обнаруживает только модели, разрешенные для этого ключа, направляет каждую модель через объявленный для нее протокол и сообщает бюджет ключа и совокупное использование в поверхностях использования OpenClaw.
Вы не устанавливаете и не аутентифицируете каждый вышестоящий Plugin поставщика на хосте OpenClaw. Вышестоящие учетные данные и перенаправление, специфичное для поставщика, остаются в ClawRouter. OpenClaw нужны только встроенный Plugin `@openclaw/clawrouter` и выданные учетные данные ClawRouter.
| Свойство | Значение |
| ---------------- | ------------------------------------------------- |
| Поставщик | `clawrouter` |
| Пакет | `@openclaw/clawrouter` |
| Аутентификация | `CLAWROUTER_API_KEY` |
| URL по умолчанию | `https://clawrouter.openclaw.ai` |
| Каталог моделей | Ограничен учетными данными через `/v1/catalog` |
| Квоты | Месячный бюджет и использование через `/v1/usage` |
## Начало работы
Попросите администратора ClawRouter выдать учетные данные, политика которых включает
поставщиков, модели и месячный бюджет, которые вам следует использовать. Учетные данные
показываются один раз при выдаче.
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
```
Plugin встроен в OpenClaw. Если в вашей конфигурации задано
`plugins.allow`, добавьте `clawrouter` в этот список перед включением. Для
пользовательского развертывания задайте `models.providers.clawrouter.baseUrl` равным
источнику ClawRouter; по умолчанию используется `https://clawrouter.openclaw.ai`.
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --all --provider clawrouter
```
Используйте возвращенные ссылки на модели точно в показанном виде. Они сохраняют вышестоящее
пространство имен, например `clawrouter/openai/...`, `clawrouter/anthropic/...` или
`clawrouter/google/...`. Если `agents.defaults.models` в вашей
конфигурации является списком разрешений, добавьте в него каждую выбранную ссылку ClawRouter.
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models set clawrouter//
```
Также можно выбрать возвращенную модель для одного запуска с помощью
`openclaw agent --model clawrouter// --message "..."`.
## Обнаружение моделей
`GET /v1/catalog` является источником истины. OpenClaw не поставляет второй,
фиксированный список моделей ClawRouter. Модель, настроенная в ClawRouter, появляется, когда:
* политика учетных данных предоставляет доступ к ее поставщику;
* подключение поставщика включено и готово;
* модель каталога объявляет поддерживаемую возможность LLM; и
* каталог предоставляет транспортный контракт, поддерживаемый Plugin.
Поэтому добавление другой модели к поддерживаемому поставщику ClawRouter не
требует релиза OpenClaw или другого Plugin поставщика. Следующее обновление каталога
обнаружит ее. Модель, которой нужен новый сетевой протокол, требует поддержки
в Plugin ClawRouter до того, как OpenClaw начнет ее объявлять.
## Протокол и Plugin поставщиков
Вам не нужно устанавливать Plugin аутентификации каждой вышестоящей компании. ClawRouter
владеет вышестоящими учетными данными; его каталог сообщает OpenClaw, какой транспорт использовать.
Plugin поддерживает:
| Маршрут каталога | Транспорт OpenClaw |
| ----------------------------------------- | ---------------------- |
| Чат, совместимый с OpenAI | `openai-completions` |
| Responses, совместимый с OpenAI | `openai-responses` |
| Нативные Anthropic Messages | `anthropic-messages` |
| Нативная потоковая передача Google Gemini | `google-generative-ai` |
Plugin также применяет соответствующие политики воспроизведения и схем инструментов для этих
семейств. Строки каталога, использующие другой формат запроса/потока, намеренно
не объявляются как текстовые модели OpenClaw. Нормализуйте таких поставщиков к одному из
поддерживаемых контрактов в ClawRouter, а не отправляйте несовместимую полезную нагрузку.
## Квоты и использование
Ответ ClawRouter `/v1/usage` питает обычные поверхности использования поставщика
OpenClaw. `/status` и связанные состояния панели управления показывают окно месячного бюджета,
когда у ключа есть лимит, а также итоговые значения запросов, токенов и расходов. Ключи без учета
по-прежнему показывают совокупное использование без процентного окна.
Поиск квоты использует тот же ключ с ограниченной областью действия, что и обнаружение моделей. Неудачный поиск квоты
не блокирует выполнение модели.
Проверьте живой снимок с помощью:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status --usage
openclaw models status
```
Тот же снимок поставщика доступен для `/status` в чате и пользовательском интерфейсе
использования OpenClaw. Бюджет действует на всю политику, поэтому запросы, выполненные другим клиентом с
той же политикой ClawRouter, могут изменить оставшийся процент.
## Устранение неполадок
| Симптом | Проверка |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Нет моделей ClawRouter | Подтвердите, что Plugin включен и разрешен `plugins.allow`, затем проверьте, что учетные данные активны и предоставляют доступ хотя бы к одному готовому поставщику. |
| Настроенная модель ClawRouter отсутствует | Проверьте ее возможность и формат маршрута в `/v1/catalog`. Неподдерживаемые транспортные контракты намеренно фильтруются. |
| `Unknown model: clawrouter/...` | Добавьте точную ссылку из каталога в `agents.defaults.models`, когда эта карта конфигурации используется как список разрешений. |
| `401` или `403` из каталога или использования | Перевыпустите или измените область действия учетных данных ClawRouter; OpenClaw не откатывается к вышестоящим ключам поставщиков. |
| Вызов модели завершается ошибкой после обнаружения | Проверьте подключение поставщика и состояние вышестоящего сервиса в ClawRouter, затем повторите попытку после восстановления состояния готовности. |
| В использовании есть итоги, но нет процента | Политика не имеет учета; добавьте месячный бюджет в ClawRouter, чтобы показать процентное окно. |
## Поведение безопасности
* Обнаружение каталога ограничено настроенным ключом прокси и кэшируется для каждого ключа.
* Ключ прокси прикрепляется только при отправке запроса; он не сохраняется в метаданных модели.
* Нативные идентификаторы моделей Anthropic и Gemini переписываются в их вышестоящие идентификаторы только при отправке.
* Неподдерживаемые или не предоставленные строки каталога завершаются закрыто и недоступны для выбора.
## Связанные материалы
Конфигурация поставщиков и выбор моделей.
Поверхности использования и состояния OpenClaw.