---
read_when:
- Вам потрібен один керований ключ для кількох постачальників моделей
- Вам потрібні виявлення моделей ClawRouter або звітування про квоти в OpenClaw
summary: Спрямовуйте моделі з обліковими даними певної області через ClawRouter і показуйте керовані квоти
title: ClawRouter
x-i18n:
generated_at: "2026-07-04T04:04:31Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: 363426cc68e74f6a910f6fa956c323449ab827aee43db4320e98620245e593d2
source_path: providers/clawrouter.md
workflow: 16
---
ClawRouter надає OpenClaw один ключ з обмеженою політикою для кількох upstream-постачальників моделей.
Вбудований plugin виявляє лише моделі, дозволені для цього ключа,
маршрутизує кожну модель через її оголошений протокол і показує бюджет ключа
та сукупне використання в інтерфейсах використання OpenClaw.
Ви не встановлюєте й не автентифікуєте кожен upstream provider plugin на хості
OpenClaw. Upstream-облікові дані та пересилання, специфічне для постачальника, залишаються в
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` як origin
ClawRouter; типове значення — `https://clawrouter.openclaw.ai`.
```bash
openclaw models list --all --provider clawrouter
```
Використовуйте повернені посилання на моделі точно так, як показано. Вони зберігають upstream
простір імен, як-от `clawrouter/openai/...`, `clawrouter/anthropic/...` або
`clawrouter/google/...`. Якщо `agents.defaults.models` у вашій
конфігурації є allowlist, додайте до нього кожне вибране посилання ClawRouter.
```bash
openclaw models set clawrouter//
```
Ви також можете вибрати повернену модель для одного запуску за допомогою
`openclaw agent --model clawrouter// --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 |
| ------------------------------------- | ----------------------- |
| Чат, сумісний з OpenAI | `openai-completions` |
| Responses, сумісні з OpenAI | `openai-responses` |
| Нативні Anthropic Messages | `anthropic-messages` |
| Нативний потоковий Google Gemini | `google-generative-ai` |
Plugin також застосовує відповідні політики replay і tool-schema для цих
сімейств. Рядки каталогу, що використовують інший формат запиту/потоку, навмисно
не показуються як текстові моделі OpenClaw. Нормалізуйте цих постачальників до одного з
підтримуваних контрактів у ClawRouter, а не надсилайте несумісне payload.
## Квоти та використання
Відповідь ClawRouter `/v1/usage` наповнює звичайні інтерфейси використання
постачальників OpenClaw. `/status` і пов’язаний статус dashboard показують вікно місячного бюджету,
коли ключ має ліміт, а також підсумки запитів, токенів і витрат. Ключі без ліміту
все одно показують сукупне використання без відсоткового вікна.
Пошук квоти використовує той самий обмежений ключ, що й виявлення моделей. Невдалий пошук квоти
не блокує виконання моделі.
Перевірте live snapshot за допомогою:
```bash
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.