OpenClaw через kosareva.cloud
OpenClaw — открытый AI-агент, который вы разворачиваете на своём сервере и общаетесь с ним через мессенджеры: Telegram, Discord, Slack. Он не просто отвечает, а выполняет задачи, помнит контекст переписки и умеет работать по расписанию. Модели агент берёт через OpenAI-совместимый API — значит, подключается к нам напрямую, в рублях и без VPN.
Как подключить
/1Получите ключ
В личном кабинете создайте API-ключ и пополните баланс. Один ключ обслуживает все модели каталога — заводить отдельный под агента не нужно.
/2Установите OpenClaw
На Linux, macOS и WSL2 — скриптом с сайта проекта:
curl -fsSL https://openclaw.ai/install.sh | bash
На Windows — в PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex
Или через npm — понадобится Node.js 24.16+ или 26.1+:
npm install -g openclaw@latest --allow-scripts=openclaw
/3Пропишите наш провайдер
Откройте ~/.openclaw/openclaw.json и добавьте
kosareva.cloud как провайдера моделей:
{
"models": {
"mode": "merge",
"providers": {
"kosareva": {
"baseUrl": "https://api.kosareva.cloud/v1",
"apiKey": "ВАШ_API_КЛЮЧ",
"api": "openai-completions",
"models": [
{
"id": "claude-opus-5",
"name": "Claude Opus 5",
"reasoning": true,
"input": ["text", "image"]
},
{
"id": "gemini-3-5-flash",
"name": "Gemini 3.5 Flash",
"input": ["text", "image"]
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "kosareva/claude-opus-5",
"fallbacks": ["kosareva/gemini-3-5-flash"]
}
}
}
}
Модель указывается как провайдер/модель. В
fallbacks удобно поставить модель подешевле: если основная
окажется недоступна, агент переключится сам. Полный список моделей и цены —
на странице цен.
/4Запустите агента
Мастер настройки подключит мессенджеры, проверит конфиг и запустит шлюз OpenClaw как службу:
openclaw onboard --install-daemon
Проверить, что шлюз работает:
openclaw gateway status
Напишите боту первое сообщение — расход появится в кабинете сразу после ответа.
Список моделей
OpenClaw подключает нас как свой провайдер с api: "openai-completions". Модели перечисляются в конфиге; для картинок у модели указывается input: ["text", "image"].
- Протокол
- OpenAI-совместимый, Chat Completions
- Адрес
https://api.kosareva.cloud/v1- Имя модели
- как в каталоге, латиницей через дефисы:
claude-sonnet-5-5 - Подходят
- Любая текстовая модель каталога — сейчас их 105; агенту нужна модель с вызовом инструментов.
| Модель | Имя в запросе | Контекст, токенов | Вход / выход за 1M |
|---|---|---|---|
| Claude Sonnet 5.5 | claude-sonnet-5-5 | 1 000 000 | 216 / 1 080 ₽ |
| Claude Opus 5.5 | claude-opus-5-5 | 1 000 000 | 432 / 2 160 ₽ |
| GPT-6.1 Sol | gpt-6-1-sol | 1 050 000 | 216 / 1 080 ₽ |
| Gemini 3.8 Flash | gemini-3-8-flash | 1 048 576 | 81 / 405 ₽ |
| Kimi K2.7 Code | kimi-k2-7-code | 262 144 | 103 / 432 ₽ |
| GLM-5.3 | glm-5-3 | 1 310 720 | 151 / 475 ₽ |
| Qwen3.8 Max | qwen3-8-max | 1 000 000 | 216 / 648 ₽ |
| DeepSeek V4.1 Flash | deepseek-v4-1-flash | 1 048 576 | 32,4 / 130 ₽ |
Контекст из таблицы — значение для contextWindow модели в конфиге OpenClaw. Все модели с ценами — на странице цен. Точные имена отдаёт и сам API по адресу /v1/models.
Какие функции OpenClaw работают через kosareva.cloud
OpenClaw работает на вашем сервере, к нам он ходит только за ответами модели.
Telegram и веб-чат работает
Telegram входит в комплект, веб-чат — в ядро. Discord, Slack, WhatsApp и другие подключаются плагинами.
Основная модель и резерв работает
primary и fallbacks — обе модели могут быть из каталога: если основная не ответит, агент переключится сам.
Картинки на входе работает
Для моделей с input: ["text", "image"].
Озвучка и поиск по памяти с оговорками
OpenClaw можно направить на любой OpenAI-совместимый адрес. С нашим API эти функции мы не проверяли.
Веб-поиск с оговорками
Большинство поисковых бэкендов OpenClaw требует своего ключа; бесплатные задаются в конфиге явно.
Рекомендуемые модели для OpenClaw
У OpenClaw есть основная модель и резервные. Удобная схема — сильная модель для разговора и дешёвая на подхвате.
Claude Sonnet 5.5 claude-sonnet-5-5
Основная для разговора и задач с инструментами, понимает картинки. Дешевле Claude Opus 5 из примера выше.
Claude Opus 5.5 claude-opus-5-5
Новый флагман Anthropic — и дешевле Opus 5 из примера. Ставьте основной, если агент делает многошаговую работу.
Gemini 3.8 Flash gemini-3-8-flash
Быстрая мультимодальная модель на подхвате: текст, картинки, видео и аудио на входе.
DeepSeek V4.1 Flash deepseek-v4-1-flash
Для простых ответов и задач по расписанию: в разы дешевле флагманов.
Устранение неполадок
Наши ошибки приходят с русским текстом — по нему и ищите свой случай. Подробные разборы — в справочнике.
401: «Ключ не найден» или «Ключ не принят»
Ключ скопирован не целиком, с пробелом или переносом строки, удалён в кабинете — или вставлен не в то поле. В OpenClaw ключ — apiKey провайдера. Переменные в конфиге пишутся только заглавными: ${KOSAREVA_API_KEY}.
404: адрес без /v1 или с лишним хвостом
Базовый адрес — ровно https://api.kosareva.cloud/v1. Без /v1 запрос уходит мимо API, а с /chat/completions на конце путь удваивается — инструмент допишет его сам. В OpenClaw это baseUrl провайдера, а api должно быть ровно openai-completions.
«Такой модели нет в каталоге»
Имя модели — как в каталоге: латиницей через дефисы, например claude-sonnet-5-5. Вариант через точку шлюз поймёт сам, а с префиксом вендора (anthropic/…), датой версии или пробелом — нет. Модель агента указывается как kosareva/claude-opus-5, а id внутри провайдера — как в каталоге. Если OpenClaw пишет, что модель не разрешена, проверьте список agents.defaults.modelPolicy.allow.
402: «Закончились средства на балансе»
На балансе не хватает денег на запрос. Пополните его в кабинете картой или СБП — от 50 ₽. Если деньги на балансе есть, а отказ повторяется, проверьте, не стоит ли у ключа свой лимит в рублях.
Ответ обрывается на полуслове
Модель упёрлась в потолок длины ответа — max_tokens. Поднимите его или попросите модель продолжить. В OpenClaw потолок — maxTokens у модели в конфиге. Обратная ошибка — 400 «Запрос длиннее, чем помещается в контекст этой модели»: потолок ответа вместе с историей не влезает в окно модели. Тогда уменьшите потолок или сожмите историю.
Долго нет ответа или 504
Длинный ответ без потоковой выдачи идёт минутами, и инструмент может сдаться раньше модели. OpenClaw обрывает запрос, если от модели долго нет данных; поднимите timeoutSeconds у провайдера — в примере документации OpenClaw стоит 300. Если пришёл наш 504 «Модель не ответила за отведённое время», деньги за такой запрос не списываются — повторите его.
Непонятно, что именно не работает
openclaw status --all, openclaw doctor и openclaw logs --follow показывают, какая часть молчит: шлюз, канал мессенджера или модель.
Частые вопросы
Нужен ли свой сервер?
Да, OpenClaw разворачивается на вашей машине. Если не хочется — держим его у себя: см. OpenClaw под ключ.
Нужен ли VPN?
Для нашего API — нет, он отвечает из России напрямую. Мессенджеры подключаются отдельно и от нас не зависят.
Можно ли смешивать модели разных вендоров?
Да. Основная и резервные модели — любые из каталога, все идут через один ключ и один баланс.
Сколько стоит агент в месяц?
Только токены, абонентской платы нет. Заведите агенту отдельный ключ с лимитом в рублях — так ночная ошибка не съест весь баланс.
Рекомендуемые модели и цены
На странице модели — все цены, включая кэш, и калькулятор расхода.
Claude Sonnet 5.5
Новый Sonnet: прямая замена Sonnet 5 по той же цене
Claude Opus 5.5
Новый флагман Anthropic для агентного кода и рабочих задач
Gemini 3.8 Flash
Самая сильная модель линейки Flash: код, агенты и многошаговые рассуждения
DeepSeek V4.1 Flash
Новая Flash с рассуждениями и картинками