Перейти до основного вмісту
ClawRouter надає OpenClaw один ключ з обмеженою політикою для кількох upstream-постачальників моделей. Вбудований plugin виявляє лише моделі, дозволені для цього ключа, маршрутизує кожну модель через її оголошений протокол і показує бюджет ключа та сукупне використання в інтерфейсах використання OpenClaw. Ви не встановлюєте й не автентифікуєте кожен upstream provider plugin на хості OpenClaw. Upstream-облікові дані та пересилання, специфічне для постачальника, залишаються в ClawRouter. OpenClaw потрібен лише вбудований plugin @openclaw/clawrouter і видані облікові дані ClawRouter.
ВластивістьЗначення
Постачальникclawrouter
Пакет@openclaw/clawrouter
АвтентифікаціяCLAWROUTER_API_KEY
Типова URLhttps://clawrouter.openclaw.ai
Каталог моделейОбмежений обліковими даними через /v1/catalog
КвотиМісячний бюджет і використання через /v1/usage

​
Початок роботи

1

Отримайте обмежені облікові дані

Попросіть адміністратора ClawRouter надати облікові дані, політика яких охоплює постачальників, моделі та місячний бюджет, які вам слід використовувати. Облікові дані показуються один раз під час видачі.
2

Налаштуйте OpenClaw

export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
Plugin вбудовано в OpenClaw. Якщо ваша конфігурація задає plugins.allow, додайте clawrouter до цього списку перед увімкненням. Для власного розгортання задайте models.providers.clawrouter.baseUrl як origin ClawRouter; типове значення — https://clawrouter.openclaw.ai.
3

Перегляньте надані моделі

openclaw models list --all --provider clawrouter
Використовуйте повернені посилання на моделі точно так, як показано. Вони зберігають upstream простір імен, як-от clawrouter/openai/..., clawrouter/anthropic/... або clawrouter/google/.... Якщо agents.defaults.models у вашій конфігурації є allowlist, додайте до нього кожне вибране посилання ClawRouter.
4

Виберіть модель

openclaw models set clawrouter/<provider>/<model>
Ви також можете вибрати повернену модель для одного запуску за допомогою openclaw agent --model clawrouter/<provider>/<model> --message "...".

​
Виявлення моделей

GET /v1/catalog є джерелом істини. OpenClaw не постачає другого, фіксованого списку моделей ClawRouter. Модель, налаштована в ClawRouter, з’являється, коли:
  • політика облікових даних надає доступ до її постачальника;
  • підключення постачальника ввімкнене й готове;
  • модель у каталозі оголошує підтримувану можливість LLM; і
  • каталог надає транспортний контракт, підтримуваний plugin.
Тому додавання іншої моделі до підтримуваного постачальника ClawRouter не потребує релізу OpenClaw або іншого provider plugin. Наступне оновлення каталогу виявить її. Модель, якій потрібен новий wire-протокол, потребує підтримки в plugin ClawRouter, перш ніж OpenClaw показуватиме її.

​
Протокол і provider plugins

Вам не потрібно встановлювати auth plugin кожної upstream-компанії. ClawRouter володіє upstream-обліковими даними; його каталог повідомляє OpenClaw, який транспорт використовувати. Plugin підтримує:
Маршрут каталогуТранспорт OpenClaw
Чат, сумісний з OpenAIopenai-completions
Responses, сумісні з OpenAIopenai-responses
Нативні Anthropic Messagesanthropic-messages
Нативний потоковий Google Geminigoogle-generative-ai
Plugin також застосовує відповідні політики replay і tool-schema для цих сімейств. Рядки каталогу, що використовують інший формат запиту/потоку, навмисно не показуються як текстові моделі OpenClaw. Нормалізуйте цих постачальників до одного з підтримуваних контрактів у ClawRouter, а не надсилайте несумісне payload.

​
Квоти та використання

Відповідь ClawRouter /v1/usage наповнює звичайні інтерфейси використання постачальників OpenClaw. /status і пов’язаний статус dashboard показують вікно місячного бюджету, коли ключ має ліміт, а також підсумки запитів, токенів і витрат. Ключі без ліміту все одно показують сукупне використання без відсоткового вікна. Пошук квоти використовує той самий обмежений ключ, що й виявлення моделей. Невдалий пошук квоти не блокує виконання моделі. Перевірте live snapshot за допомогою: 
openclaw status --usage
openclaw models status
Той самий snapshot постачальника доступний для /status у чаті та UI використання OpenClaw. Бюджет діє на всю політику, тому запити, зроблені іншим клієнтом із тією самою політикою ClawRouter, можуть змінити відсоток, що залишився.

​
Усунення несправностей

СимптомПеревірка
Немає моделей ClawRouterПідтвердьте, що plugin увімкнено й дозволено через plugins.allow, а потім перевірте, що облікові дані активні й надають доступ принаймні до одного готового постачальника.
Налаштована модель ClawRouter відсутняПеревірте її можливості та формат маршруту в /v1/catalog. Непідтримувані транспортні контракти навмисно відфільтровуються.
Unknown model: clawrouter/...Додайте точне посилання з каталогу до agents.defaults.models, коли ця конфігураційна мапа використовується як allowlist.
401 або 403 від каталогу чи usageПеревипустіть або змініть scope облікових даних ClawRouter; OpenClaw не переходить до upstream provider keys.
Виклик моделі завершується помилкою після виявленняПеревірте підключення постачальника та upstream health у ClawRouter, а потім повторіть спробу після відновлення його стану готовності.
Usage має підсумки, але без відсоткаПолітика без ліміту; додайте місячний бюджет у ClawRouter, щоб показати відсоткове вікно.

​
Поведінка безпеки

  • Виявлення каталогу обмежене налаштованим proxy key і кешується для кожного ключа.
  • Proxy key додається лише під час dispatch запиту; він не зберігається в metadata моделі.
  • Нативні model ids Anthropic і Gemini переписуються в їхні upstream ids лише під час dispatch.
  • Непідтримувані або не надані рядки каталогу fail closed і недоступні для вибору.

​
Пов’язане

Постачальники моделей

Конфігурація постачальника та вибір моделі.

Відстеження використання

Інтерфейси використання та статусу OpenClaw.