Установка OpenClaw в России: подробный гайд

OpenClaw — open-source платформа для создания персональных AI-ассистентов. Инструмент позволяет объединить мессенджеры, API сторонних сервисов и языковые модели в единую систему, работающую под вашим полным контролем. В отличие от проприетарных решений, OpenClaw можно развернуть локально или на собственном сервере. И мы расскажем про установку OpenClaw в этой статье.

Благодаря открытому коду, инструмент полностью доступен в России без ограничений со стороны разработчика. Все компоненты, включая установочные скрипты и репозитории на GitHub, работают напрямую или через VPN.

Подготовка к установке: что нужно знать перед стартом

Перед тем как перейти к установке OpenClaw, важно убедиться, что ваша система соответствует минимальным требованиям, и понять принципы работы платформы. Это избавит вас от большинства типичных ошибок на начальном этапе.

OpenClaw написан на Node.js, поэтому основным требованием является наличие совместимой среды. Разработчики рекомендуют использовать Node.js версии 22 LTS или 24. Если на вашем компьютере Node.js ещё не установлен — не беспокойтесь, установочный скрипт скачает и настроит всё автоматически.

Системные требования к оборудованию:

• Оперативная память: от 2 ГБ.
• Свободное место: от 500 МБ.
• Операционная система: Windows (с WSL2), macOS или Linux.

Для работы в режиме 24/7 потребуется либо отдельный компьютер — например, старый ноутбук или Mac Mini — либо недорогой виртуальный сервер, VPS. Стоимость аренды VPS в российских дата-центрах начинается от 300–500 рублей в месяц.

Пошаговая установка OpenClaw

Процесс установки максимально автоматизирован. Разработчики подготовили скрипты, которые выполнят всю рутинную работу: от загрузки зависимостей до первичной настройки окружения.

Рекомендуемый способ (Linux, macOS, Windows)

Самый быстрый и надежный способ установить OpenClaw — использовать официальный инсталлятор. Он подходит для большинства пользователей.

Для Linux и macOS

Откройте терминал и выполните команду:

curl -fsSL https://openclaw.ai/install.sh | bash

Для Windows

Запустите PowerShell от имени администратора и выполните:

iwr -useb https://openclaw.ai/install.ps1 | iex

После завершения работы скрипта установка будет продолжена в терминале. Вам будет предложено пройти первичную настройку (onboarding) и установить «демон» для автоматического запуска:

openclaw onboard —install-daemon

Альтернативные методы установки

Если вы предпочитаете ручную установку или используете специфическое окружение, OpenClaw можно установить через другие менеджеры пакетов.

• Через npm: npm install -g openclaw@latest — подходит, если Node.js уже установлен глобально.
• Docker / Podman — идеальный вариант для запуска на VPS. Готовые образы доступны в документации OpenClaw.
• Nix / Kubernetes — для продвинутых пользователей, требующих тонкой настройки и изоляции.

Проверка корректности установки

После завершения установки необходимо убедиться, что все компоненты работают исправно. Для этого в OpenClaw есть встроенные команды диагностики.

Выполните в терминале:

openclaw doctor # Проверяет зависимости и конфигурацию
openclaw gateway status # Показывает статус основного шлюза

Если диагностика прошла успешно, можно открыть веб-интерфейс для дальнейшей настройки:

openclaw dashboard

Настройка OpenClaw для работы в России

После установки необходимо выполнить базовую настройку: подключить мессенджер и добавить API-ключи для языковых моделей.

Подключение бесплатных российских моделей

Основная сложность для пользователей в РФ — доступ к западным моделям вроде GPT или Claude, которые требуют зарубежных способов оплаты и обхода блокировок.

Open-source сообщество уже нашло элегантное решение для использования российских нейросетей в OpenClaw. Вы можете подключить GigaChat от Сбера и YandexGPT абсолютно бесплатно.

Для подключения GigaChat:

1. Установите прокси-сервер gpt2giga, который эмулирует API OpenAI и перенаправляет запросы к GigaChat.
2. Запустите прокси на локальном порту, например, 8443.
3. В конфигурационном файле ~/.openclaw/config/openclaw.json пропишите нового провайдера как OpenAI-совместимый, указав адрес вашего локального прокси.

Для подключения YandexGPT:

1. Создайте бесплатный сервисный аккаунт в Yandex Cloud.
2. Запустите Node.js-прокси, который будет выступать прослойкой между OpenClaw и YandexGPT.
3. Аналогично добавьте провайдера в конфигурационный файл.

Готовые русскоязычные агенты

Чтобы не настраивать всё с нуля, вы можете воспользоваться готовыми навыками из репозитория openclaw-ru-skills на GitHub. Там уже есть:

• Агент Ruslan — работает на базе GigaChat-Pro.
• Агент Яша — работает на базе YandexGPT с поддержкой двуязычного общения.

Эти агенты сразу умеют работать с Яндекс.Диском, Календарем и Почтой через стандартную OAuth-авторизацию.

Практические сценарии использования

После установки и настройки OpenClaw открывается широкий спектр возможностей — от простого чат-бота до полноценного инструмента автоматизации.

Сценарий 1: Личный ассистент в Telegram

Первое, что обычно делают русскоязычные пользователи, установив OpenClaw — подключают Telegram-бота, чтобы общаться с ассистентом через чат «телеги».

После установки OpenClaw отдайте в консоли следующую команды:

1. Создаем бота в @BotFather → получаем token
2. Открываем конфиг nano ~/.openclaw/openclaw.json

В OpenClaw вставляете примерно такой код:

{

«channels»: {«telegram»: {«enabled»: true,
«botToken»: «1234567890:AAF1b2C3d4E5f6G7H8I9J0KLMNOPQRSTUVWXYZ»,
«dmPolicy»: «pairing» // или «open», «allowlist»}}
}

Перезапускаете gateway:

openclaw gateway restart

или:

openclaw gateway start —foreground # для теста

Готово — пишете боту в Telegram, он отвечает от вашего агента.

Сценарий 2: Яндекс 360

Если не хотите ставить Руслана или Яшу, можете скачать отдельный «скилл» yax, который подключается через OAuth. Он открывает доступ к почте, календарю и облачному диску Яндекса. Но не к Яндекс.Мессенджеру — для этого скилл пока не придумали. Чатиться с агентом удобнее через Telegram.

Прежде чем подключать, убедитесь, что у вас есть действующий аккаунт на Яндексе.

1. Установка скилла через CLI

Откройте терминал и выполните команду для установки навыка из официального реестра ClawHub:

npx clawhub@latest install yax

или, если используете глобальную установку:

openclaw skills install yax

После установки скилл появится в директории ~/.openclaw/skills/yax/.

2. Проверка структуры скилла

Убедитесь, что скилл установлен корректно. В директории должны быть следующие файлы: ls -la ~/.openclaw/skills/yax/

Ожидаемая структура:

• SKILL.md — описание навыка и инструкция по использованию
• src/ — исходный код интеграции
• При необходимости — файлы конфигурации

3. Настройка доступа к Yandex 360

Для работы скиллу нужен OAuth-токен доступа к вашему аккаунту Яндекс. Если у вас его еще нет:

1. Перейдите на страницу OAuth-токенов Яндекса;
2. Нажмите «Создать приложение» или «Получить токен»;
3. Выберите права доступа (scopes), которые нужны скиллу:
   • Доступ к Яндекс.Диску: cloud_api:disk.read, cloud_api:disk.write;
   • Доступ к Почте: mail:imap_full;
   • Доступ к Календарю: calendar:all;
4. Скопируйте полученный токен.

4. Пропишите токен в конфигурацию OpenClaw

Откройте файл конфигурации OpenClaw ~/.openclaw/config/openclaw.json и добавьте настройки для Yandex 360:

{

«skills»: {
«enabled»: [«yax»], «config»: {
«yax»: {
«oauth_token»: «ВАШ_ЯНДЕКС_OAUTH_ТОКЕН», «disk_enabled»: true, «mail_enabled»: true, «calendar_enabled»: true}}}
}

5. Перезапустите шлюз

Чтобы изменения вступили в силу, перезапустите OpenClaw gateway:

openclaw gateway restart

6. Проверка работы

После перезапуска проверьте, что скилл загрузился и готов к работе:

openclaw skills list

В списке должен отображаться установленный навык yax со статусом enabled.

Теперь ваш AI-агент сможет обращаться к Яндекс.Диску, Почте и Календарю через этот скилл. Можете попросить его что-нибудь сделать, например:

• «Запиши в семейный календарь (синхронизированный с Яндекс.Календарем) день рождения бабушки 15 мая и напомни мне об этом за неделю».
• «Найди все фотографии с прошлого Нового года в переписке с ’Семейный чат’ и сохрани их в папку ’Праздники’ на Яндекс.Диск».
• «Добавь в список покупок молоко, гречку и корм для кота».

Почему это удобно: вам и вашим близким не нужно устанавливать новые приложения. Всё происходит в интерфейсе, который они уже используют для общения. Это бесшовная замена.

Заключение

Установка OpenClaw занимает буквально пару минут и не требует глубоких технических знаний. А благодаря модульной системе навыков-скиллов функциональность ассистента можно расширять под любые задачи. Попробуйте запустить своего первого AI-агента уже сегодня, и вы увидите, как много рутинных операций можно делегировать цифровому помощнику.