Перейти к основному содержанию
OpenClaw — личный ИИ-ассистент с открытым кодом (MIT), который работает на вашем компьютере или сервере и отвечает в Telegram, WhatsApp, Discord, Slack, iMessage, Teams и ещё 20+ сервисах. Своих моделей у него нет: RuAPI подключается к нему как свой провайдер (custom provider) — Claude в родном Anthropic-формате, DeepSeek, GPT и GLM в OpenAI-совместимом. Ключ один на все модели, запросы идут на www.ruapi.ai без VPN. Зачем OpenClaw провайдер RuAPI, сколько стоят модели и как платить без зарубежной карты, — коротко на странице www.ruapi.ai/openclaw-v-rossii; ниже — как всё настроить.
Инструкция сверена с исходным кодом и документацией OpenClaw (02.11.2026). Если в новой версии OpenClaw пункт меню или поле называется иначе, сверьтесь с docs.openclaw.ai.

Что понадобится

1

Аккаунт RuAPI и API-ключ

Консоль → API-ключи → Создать ключ. OpenClaw отвечает в мессенджерах и выполняет задачи по расписанию без вашего участия, поэтому задайте ключу Бюджет — больше него агент не потратит. См. API-ключи и безопасность.Новым аккаунтам обычно сразу начисляется $0,05: на этом балансе работают claude-haiku-5-5, deepseek-flash и gpt-6-luna. Остальные модели откроются после первого пополнения — в USDT от 5 USDT, зарубежная карта не нужна (как купить USDT за рубли через СБП). Принимаются и карты иностранных банков.
2

Операционная система

macOS, Linux или Windows. На Windows можно поставить приложение Windows Hub, установить OpenClaw скриптом PowerShell или работать в WSL2 — все варианты ниже.
3

Node.js — только для установки через npm

Официальный установщик сам поставит Node.js, если его нет. Если ставите через npm, нужен Node.js 24 (от 24.16) или 26 (от 26.1); разработчики рекомендуют Node 26, а ради исправлений безопасности — не ниже 24.22.1 или 26.12.1. Проверка:

Установка OpenClaw

Установщик проверит Node.js, установит OpenClaw и сразу откроет мастер настройки: в нём можно подключить RuAPI (способ 2 ниже) или выйти и прописать провайдера в файле (способ 1). Проверка установки:

Подключение RuAPI

Для OpenClaw RuAPI — это два «своих провайдера» с одним ключом: Claude лучше подключать именно в Anthropic-формате: так работает кэш Claude (см. раздел «Кэш Claude» ниже). Модели вызываются как провайдер/модель, например ruapi/claude-sonnet-5-5 или ruapi-openai/deepseek-flash.

Способ 1: файл openclaw.json (рекомендуется)

1

Откройте файл конфигурации

Обычно это ~/.openclaw/openclaw.json; точный путь покажет команда:
Если файла ещё нет, создайте его. Если есть — ничего из него не удаляйте: допишите поля из следующего шага в существующие разделы models и agents (второй такой же раздел в файле не создавайте).
2

Добавьте провайдеров и основную модель

  • id — точное название модели со страницы цен, с учётом регистра. В models перечислите все модели, которые хотите вызывать.
  • input: ["text", "image"] — модель понимает картинки: тогда OpenClaw передаёт ей фото из мессенджера как изображение. Без этого поля модель считается текстовой; у glm-5.3 его нет — она работает только с текстом.
  • fallbacks — запасные модели: если основная не ответит, OpenClaw попробует их по порядку.
Не добавляйте /v1 к адресу провайдера ruapi: Anthropic-клиент OpenClaw дописывает его сам.
На стартовом балансе $0,05 поставьте основной ruapi/claude-haiku-5-5 или ruapi-openai/deepseek-flash — claude-sonnet-5-5 заработает после первого пополнения.
3

Проверьте настройки

Gateway следит за файлом и применяет изменения сам. Проверьте конфигурацию и выбранную модель:
models status должен показать основную модель ruapi/claude-sonnet-5-5 и запасную ruapi-openai/deepseek-flash. Если изменения не подхватились — openclaw gateway restart.
Положите ключ в файл ~/.openclaw/.env:
и сошлитесь на него в обоих провайдерах: apiKey: "${RUAPI_API_KEY}". Переменные можно задать и в самом openclaw.json — в разделе env.vars, например env: { vars: { RUAPI_API_KEY: "sk-…" } }. Ключи прямо внутри env (без vars), как в старых примерах, текущая версия OpenClaw не принимает.

Способ 2: мастер openclaw onboard

Мастер удобен, если нужен один провайдер. Установщик открывает его сам; вручную он запускается так (эта же команда меняет провайдера на уже настроенной установке):
1

Найдите Custom Provider

Выберите Quick start. OpenClaw покажет найденные способы доступа к моделям (если они есть) и список провайдеров: откройте More… → Custom Provider.
2

Заполните поля

Для моделей, которых OpenClaw не знает, мастер дополнительно спросит Does this model support image input? — для моделей GLM (например, glm-5.3) ответьте «нет»: они работают только с текстом. deepseek-flash мастер сам считает текстовой; чтобы отправлять ей картинки, потом добавьте ей input: ["text", "image"] в openclaw.json.Формат выбирайте явно, а не Unknown (detect automatically): автоопределение может подключить Claude в OpenAI-формате, где OpenClaw не ставит метки кэша и остаётся только автокэш RuAPI.
3

Дождитесь проверки

Перед сохранением мастер отправит модели настоящий запрос. Если проверка не прошла, мастер предложит исправить адрес (Change base URL) или модель (Change model).
4

Второй провайдер — тем же путём

Чтобы добавить и Claude, и DeepSeek/GPT, запустите 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 своего провайдера. Полный список и цены — на странице цен. Короткие служебные задачи — заголовки сессий, сводки, пересказы переписки — OpenClaw отдаёт служебной модели. Её можно сделать недорогой:

Кэш 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".

Решение проблем

  • apiKey должен быть ключом RuAPI (sk-...), а не ключом Anthropic или OpenAI.
  • Если ключ задан как ${RUAPI_API_KEY}, проверьте, что переменная есть в ~/.openclaw/.env или в env.vars.
  • В Консоли RuAPI → API-ключи проверьте, что ключ активен и что модель входит в «Доступные модели» ключа (если список задан).
  • Перед 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.
OpenClaw принимает только конфигурацию, полностью совпадающую со схемой: из-за лишнего ключа или неверного значения Gateway не стартует. Проверьте:
Частые ошибки из старых примеров: api: "openai" вместо "openai-completions" и models в виде списка строк вместо объектов { id, name }.
Раньше здесь предлагалось задать ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY и вызывать модели как anthropic/claude-.... Встроенный провайдер anthropic рассчитан на официальный API Anthropic, поэтому перейдите на своего провайдера:
  1. Удалите ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY из env (или env.vars) в openclaw.json и из ~/.zshrc / ~/.bashrc.
  2. Добавьте провайдера ruapi, как в способе 1 выше.
  3. Замените anthropic/... на ruapi/... в agents.defaults.model.
  • Проверьте сеть: curl -I https://www.ruapi.ai.
  • Прервите мастер (Ctrl+C) и пропишите провайдера в openclaw.json вручную (способ 1 выше).
Для незнакомых OpenAI-совместимых адресов OpenClaw по умолчанию не запрашивает расход токенов в потоковом режиме. На списания в RuAPI это не влияет. Чтобы OpenClaw видел расход сам, добавьте моделям ruapi-openai поле compat: { supportsUsageInStreaming: true } — RuAPI его поддерживает.
При настройке OpenClaw создаёт регулярную задачу — проверку по расписанию (proactive check). Список задач: openclaw automations list --all, выключить лишнюю — openclaw automations disable <id>.
Ollama — встроенный провайдер OpenClaw (модели вида ollama/...). Провайдеры RuAPI добавляются рядом: например, основная модель ruapi/claude-sonnet-5-5, а локальная — в agents.defaults.model.fallbacks, или наоборот. Подробнее — в документации OpenClaw.

Подключение мессенджеров

Основная ценность OpenClaw — общение с моделью через мессенджер. После настройки RuAPI подключайте Telegram, WhatsApp, Discord и другие каналы по документации каналов OpenClaw — запросы к моделям автоматически пойдут через RuAPI.

См. также

Кэширование промптов

Как повторяющийся контекст обходится минимум в 10 раз дешевле.

Hermes Agent

Ближайший аналог OpenClaw — тоже на RuAPI.

Как купить USDT за рубли

Crypto Bot, Bybit P2P или обменник — три способа.