@openclaw/clawrouter и выданные учетные данные ClawRouter.
| Свойство | Значение |
|---|---|
| Поставщик | clawrouter |
| Пакет | @openclaw/clawrouter |
| Аутентификация | CLAWROUTER_API_KEY |
| URL по умолчанию | https://clawrouter.openclaw.ai |
| Каталог моделей | Ограничен учетными данными через /v1/catalog |
| Квоты | Месячный бюджет и использование через /v1/usage |
Начало работы
Получите учетные данные с ограниченной областью действия
Попросите администратора ClawRouter выдать учетные данные, политика которых включает
поставщиков, модели и месячный бюджет, которые вам следует использовать. Учетные данные
показываются один раз при выдаче.
Настройте OpenClaw
plugins.allow, добавьте clawrouter в этот список перед включением. Для
пользовательского развертывания задайте models.providers.clawrouter.baseUrl равным
источнику ClawRouter; по умолчанию используется https://clawrouter.openclaw.ai.Выведите список предоставленных моделей
clawrouter/openai/..., clawrouter/anthropic/... или
clawrouter/google/.... Если agents.defaults.models в вашей
конфигурации является списком разрешений, добавьте в него каждую выбранную ссылку ClawRouter.Обнаружение моделей
GET /v1/catalog является источником истины. OpenClaw не поставляет второй,
фиксированный список моделей ClawRouter. Модель, настроенная в ClawRouter, появляется, когда:
- политика учетных данных предоставляет доступ к ее поставщику;
- подключение поставщика включено и готово;
- модель каталога объявляет поддерживаемую возможность LLM; и
- каталог предоставляет транспортный контракт, поддерживаемый Plugin.
Протокол и Plugin поставщиков
Вам не нужно устанавливать Plugin аутентификации каждой вышестоящей компании. ClawRouter владеет вышестоящими учетными данными; его каталог сообщает OpenClaw, какой транспорт использовать. Plugin поддерживает:| Маршрут каталога | Транспорт OpenClaw |
|---|---|
| Чат, совместимый с OpenAI | openai-completions |
| Responses, совместимый с OpenAI | openai-responses |
| Нативные Anthropic Messages | anthropic-messages |
| Нативная потоковая передача Google Gemini | google-generative-ai |
Квоты и использование
Ответ ClawRouter/v1/usage питает обычные поверхности использования поставщика
OpenClaw. /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.