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