Providers
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 выдать учетные данные, политика которых включает поставщиков, модели и месячный бюджет, которые вам следует использовать. Учетные данные показываются один раз при выдаче.
Настройте OpenClaw
export CLAWROUTER_API_KEY="..."openclaw onboard --auth-choice clawrouter-api-keyopenclaw plugins enable clawrouterPlugin встроен в OpenClaw. Если в вашей конфигурации задано
plugins.allow, добавьте clawrouter в этот список перед включением. Для
пользовательского развертывания задайте models.providers.clawrouter.baseUrl равным
источнику ClawRouter; по умолчанию используется https://clawrouter.openclaw.ai.
Выведите список предоставленных моделей
openclaw models list --all --provider clawrouterИспользуйте возвращенные ссылки на модели точно в показанном виде. Они сохраняют вышестоящее
пространство имен, например clawrouter/openai/..., clawrouter/anthropic/... или
clawrouter/google/.... Если agents.defaults.models в вашей
конфигурации является списком разрешений, добавьте в него каждую выбранную ссылку ClawRouter.
Выберите модель
openclaw models set clawrouter/<provider>/<model>Также можно выбрать возвращенную модель для одного запуска с помощью
openclaw agent --model clawrouter/<provider>/<model> --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 и связанные состояния панели управления показывают окно месячного бюджета,
когда у ключа есть лимит, а также итоговые значения запросов, токенов и расходов. Ключи без учета
по-прежнему показывают совокупное использование без процентного окна.
Поиск квоты использует тот же ключ с ограниченной областью действия, что и обнаружение моделей. Неудачный поиск квоты не блокирует выполнение модели.
Проверьте живой снимок с помощью:
openclaw status --usageopenclaw 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 переписываются в их вышестоящие идентификаторы только при отправке.
- Неподдерживаемые или не предоставленные строки каталога завершаются закрыто и недоступны для выбора.
