www.ruapi.ai без VPN.
Зачем OpenClaw провайдер RuAPI, сколько стоят модели и как платить без зарубежной карты, — коротко на странице www.ruapi.ai/openclaw-v-rossii; ниже — как всё настроить.
Что понадобится
Аккаунт RuAPI и API-ключ
claude-haiku-5-5, deepseek-flash и gpt-6-luna. Остальные модели откроются после первого пополнения — в USDT от 5 USDT, зарубежная карта не нужна (как купить USDT за рубли через СБП). Принимаются и карты иностранных банков.Операционная система
Node.js — только для установки через npm
Установка OpenClaw
- macOS / Linux / WSL2
- Windows (PowerShell)
- Windows Hub
- npm
Подключение RuAPI
Для OpenClaw RuAPI — это два «своих провайдера» с одним ключом:провайдер/модель, например ruapi/claude-sonnet-5-5 или ruapi-openai/deepseek-flash.
Способ 1: файл openclaw.json (рекомендуется)
Откройте файл конфигурации
~/.openclaw/openclaw.json; точный путь покажет команда:models и agents (второй такой же раздел в файле не создавайте).Добавьте провайдеров и основную модель
id— точное название модели со страницы цен, с учётом регистра. Вmodelsперечислите все модели, которые хотите вызывать.input: ["text", "image"]— модель понимает картинки: тогда OpenClaw передаёт ей фото из мессенджера как изображение. Без этого поля модель считается текстовой; уglm-5.3его нет — она работает только с текстом.fallbacks— запасные модели: если основная не ответит, OpenClaw попробует их по порядку.
Проверьте настройки
models status должен показать основную модель ruapi/claude-sonnet-5-5 и запасную ruapi-openai/deepseek-flash. Если изменения не подхватились — openclaw gateway restart.Как не хранить ключ прямо в openclaw.json
Как не хранить ключ прямо в openclaw.json
~/.openclaw/.env:apiKey: "${RUAPI_API_KEY}". Переменные можно задать и в самом openclaw.json — в разделе env.vars, например env: { vars: { RUAPI_API_KEY: "sk-…" } }. Ключи прямо внутри env (без vars), как в старых примерах, текущая версия OpenClaw не принимает.Способ 2: мастер openclaw onboard
Мастер удобен, если нужен один провайдер. Установщик открывает его сам; вручную он запускается так (эта же команда меняет провайдера на уже настроенной установке):Найдите Custom Provider
Заполните поля
glm-5.3) ответьте «нет»: они работают только с текстом. deepseek-flash мастер сам считает текстовой; чтобы отправлять ей картинки, потом добавьте ей input: ["text", "image"] в openclaw.json.Формат выбирайте явно, а не Unknown (detect automatically): автоопределение может подключить Claude в OpenAI-формате, где OpenClaw не ставит метки кэша и остаётся только автокэш RuAPI.Дождитесь проверки
Второй провайдер — тем же путём
openclaw onboard ещё раз и добавьте второй Custom Provider со своим Endpoint ID. Основную модель потом можно сменить командой openclaw models set ruapi/claude-sonnet-5-5.Первый запрос
Откройте чат прямо в терминале и попросите поздороваться одним предложением по-русски:openclaw dashboard и напишите сообщение там.
В ответ должно прийти сообщение, а в Консоли RuAPI → Журнал запросов — запись с выбранной моделью. Реальные списания смотрите именно там: в собственной статистике OpenClaw цена модели без поля cost считается нулевой.
Чтобы Gateway работал в фоне и после перезагрузки, установите его как службу: openclaw gateway install (или openclaw onboard --install-daemon). Состояние — openclaw gateway status.
Выбор другой модели
agents.defaults.model.primary в openclaw.json. Модель должна быть перечислена в models своего провайдера.
Кэш Claude
-
Anthropic-формат (провайдер
ruapi). OpenClaw сам ставит меткиcache_controlна описания инструментов, системные инструкции и последние сообщения — кэш живёт 5 минут. Повторяющийся контекст агента оплачивается по цене чтения кэша. -
Кэш на 1 час включается параметром
cacheRetention: "long"для конкретной модели. Запись в такой кэш стоит 2 × цена ввода (см. кэширование промптов)."short"— обычный кэш на 5 минут,"none"— без меток. -
OpenAI-формат. Если подключить Claude через
ruapi-openai, OpenClaw меток для него не ставит, и остаётся только автокэш RuAPI: на первом ходу нового диалога кэшируются в лучшем случае только системный промпт и инструменты, а после перерыва больше 5 минут кэш истекает. У DeepSeek и GPT кэш работает сам, меток не требует.
cacheRetention: "short".
Решение проблем
Модель не найдена (503) или 404
Модель не найдена (503) или 404
- Перед ID модели должен стоять провайдер:
ruapi/claude-sonnet-5-5,ruapi-openai/deepseek-flash. - Модель должна быть в
modelsэтого провайдера, а еёid— совпадать с названием на странице цен, включая регистр (GLM-5.2, ноglm-5.3). baseUrl: дляanthropic-messages—https://www.ruapi.ai, дляopenai-completions—https://www.ruapi.ai/v1.- До первого пополнения работают только
claude-haiku-5-5,deepseek-flashиgpt-6-luna.
Gateway не запускается после правки openclaw.json
Gateway не запускается после правки openclaw.json
api: "openai" вместо "openai-completions" и models в виде списка строк вместо объектов { id, name }.Настраивали по старой версии этой инструкции (ANTHROPIC_BASE_URL)
Настраивали по старой версии этой инструкции (ANTHROPIC_BASE_URL)
ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY и вызывать модели как anthropic/claude-.... Встроенный провайдер anthropic рассчитан на официальный API Anthropic, поэтому перейдите на своего провайдера:- Удалите
ANTHROPIC_BASE_URLиANTHROPIC_API_KEYизenv(илиenv.vars) вopenclaw.jsonи из~/.zshrc/~/.bashrc. - Добавьте провайдера
ruapi, как в способе 1 выше. - Замените
anthropic/...наruapi/...вagents.defaults.model.
openclaw onboard зависает или проверка не проходит
openclaw onboard зависает или проверка не проходит
- Проверьте сеть:
curl -I https://www.ruapi.ai. - Прервите мастер (Ctrl+C) и пропишите провайдера в
openclaw.jsonвручную (способ 1 выше).
OpenClaw пишет «returned no token usage» для моделей ruapi-openai
OpenClaw пишет «returned no token usage» для моделей ruapi-openai
ruapi-openai поле compat: { supportsUsageInStreaming: true } — RuAPI его поддерживает.Агент тратит токены, когда я ему не пишу
Агент тратит токены, когда я ему не пишу
openclaw automations list --all, выключить лишнюю — openclaw automations disable <id>.Ollama и RuAPI одновременно
Ollama и RuAPI одновременно
ollama/...). Провайдеры RuAPI добавляются рядом: например, основная модель ruapi/claude-sonnet-5-5, а локальная — в agents.defaults.model.fallbacks, или наоборот. Подробнее — в документации OpenClaw.