---
read_when:
- Вам нужен один управляемый ключ для нескольких поставщиков моделей
- Вам нужно обнаружение моделей ClawRouter или отчетность по квотам в OpenClaw
summary: Направляйте модели с учетными данными через ClawRouter и показывайте управляемые квоты
title: ClawRouter
x-i18n:
generated_at: "2026-07-04T03:58:51Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: 363426cc68e74f6a910f6fa956c323449ab827aee43db4320e98620245e593d2
source_path: providers/clawrouter.md
workflow: 16
---
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
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
openclaw models list --all --provider clawrouter
```
Используйте возвращенные ссылки на модели точно в показанном виде. Они сохраняют вышестоящее
пространство имен, например `clawrouter/openai/...`, `clawrouter/anthropic/...` или
`clawrouter/google/...`. Если `agents.defaults.models` в вашей
конфигурации является списком разрешений, добавьте в него каждую выбранную ссылку ClawRouter.
```bash
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
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.