Установка OpenClaw на VPS

OpenClaw — личный ИИ-агент: вы пишете ему в мессенджере или в веб-панели, а он выполняет задачи. Сама языковая модель работает у стороннего поставщика по API. На вашем сервере живёт только программа-посредник (в документации она называется Gateway): она принимает сообщения, вызывает модель по вашему ключу и выполняет действия. Поэтому мощная видеокарта не нужна. Подробнее о самом проекте: OpenClaw в каталоге ИИ-агентов, там же указано, у каких хостеров он ставится в один клик.

Команды ниже взяты со страниц официальной документации OpenClaw (адреса в разделе «sources») и проверены 6 октября 2026 года на VPS с Ubuntu 24.04, 2 ядрами и 2 ГБ памяти. Версия OpenClaw на момент проверки: 2026.9.8. Мы прошли установку, запуск службы, перезагрузку и команды обновления; модель по ключу API не подключали, поэтому про работу самого агента здесь выводов нет. Проект быстро меняется, перед установкой сверьтесь со страницей docs.openclaw.ai/install.

Какой сервер нужен

Официального минимума для обычного VPS мы в документации не нашли. Для сборки образа из исходников в разделе про Docker указано не менее 6 ГБ памяти, а для готового образа сказано, что небольшим хостам лучше брать его.

На нашем тестовом сервере с 2 ГБ памяти OpenClaw установился и запустился. Служба Gateway без подключённых каналов и задач занимала около 830 МБ памяти (на пике 930 МБ), программа на диске заняла около 740 МБ. То есть на 2 ГБ он работает, но впритык: почти половина памяти уходит только на то, чтобы служба была запущена.

Поэтому наш ориентир: 2 ядра и 4 ГБ памяти, а если сервер будет делать много задач сразу, больше. Конфигурации с такими параметрами в нашей базе стоят от 650 ₽ до 2 319 ₽ в месяц (данные на 7 октября 2026 года). Смотрите страницу 2 ядра, 4 ГБ или подбор с фильтром.

Из программного обеспечения документация требует Node.js версии 24.16 и выше или 26.1 и выше (рекомендуется 26). Ставить его заранее не нужно: установщик сделает это сам. Также вам понадобится ключ API от поставщика модели или вход через поддерживаемый клиент.

Docker для установки по этой инструкции не нужен. Если захотите запускать OpenClaw в контейнере, сначала поставьте Docker по статье установка Docker на VPS и следуйте разделу Docker официальной документации.

Шаг 1. Подготовьте сервер

Подключитесь к серверу по SSH и создайте обычного пользователя с sudo, если ещё не сделали это: первая настройка VPS. Запускать агента лучше не от root: у него будет доступ к файлам и командам на сервере.

Важно: зайдите на сервер по SSH сразу под этим пользователем (ssh имя@адрес_сервера), а не переключайтесь на него из-под root командой su. При входе через su у пользователя нет своей сессии systemd, и на шаге 3 мастер не сможет поставить службу: мы получили сообщение Systemd user services are unavailable; skipping service install. После обычного входа по SSH та же команда отработала без ошибок.

Обновите пакеты:

sudo apt update && sudo apt upgrade -y

Команда обновляет список пакетов и ставит доступные обновления.

Шаг 2. Запустите официальный установщик

Для Linux документация даёт такую команду:

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

Она скачивает скрипт установки с сайта проекта и сразу выполняет его в bash. Если не хотите запускать чужой скрипт вслепую, сначала скачайте его в файл, прочитайте и запустите вручную.

Что делает установщик (у нас это заняло около двух минут): ставит инструменты сборки и Node.js из репозитория NodeSource (у нас встала версия 24.21), затем сам OpenClaw как пакет npm в домашний каталог пользователя, в ~/.npm-global. Системные пакеты он ставит через sudo, поэтому у пользователя должны быть права sudo.

В конце установщик дописывает путь к программе в ~/.bashrc. В уже открытом терминале команда openclaw ещё не найдётся, поэтому перечитайте настройки и проверьте версии:

source ~/.bashrc
node --version
openclaw --version

Если Node.js оказался старее 24.16, поставьте его по инструкции на странице установки OpenClaw.

Шаг 3. Пройдите первичную настройку и поставьте службу

openclaw onboard --install-daemon

Мастер первичной настройки спросит, каким поставщиком модели пользоваться, и поможет подключить каналы. Флаг --install-daemon устанавливает фоновую службу. На Linux это пользовательская служба systemd: у нас мастер создал файл ~/.config/systemd/user/openclaw-gateway.service.

Ключ API поставщика мастер попросит ввести сам. Не вставляйте ключ в чат, публичные репозитории и скриншоты.

Настройки мастер кладёт в каталог ~/.openclaw/, главный файл там openclaw.json. У нас он сразу создался с правами 600, то есть читать его может только владелец. Проверьте у себя:

ls -la ~/.openclaw/

Файла ~/.openclaw/.env мастер не создаёт. Если вы сами заведёте такой файл для ключей в переменных окружения, поставьте на него те же права: chmod 600 ~/.openclaw/.env. По документации переменные окружения, например OPENCLAW_GATEWAY_TOKEN, имеют приоритет над файлом конфигурации.

Шаг 4. Проверьте, что служба работает

openclaw gateway status

Команда показывает состояние службы. В исправном состоянии в выводе есть строки Runtime: running, Connectivity probe: ok и Listening: 127.0.0.1:18789. Сразу после установки служба стартует не мгновенно: у нас мастер в конце написал Gateway did not become reachable, а через полминуты та же проверка уже показывала, что всё работает. Если увидели такое сообщение, подождите минуту и повторите команду.

Gateway слушает порт 18789 только на локальном адресе (loopback): так написано в документации, и так было у нас. Снаружи он недоступен, и это правильно: не открывайте этот порт в интернет.

Панель управления работает на том же порту, адрес показывает команда openclaw dashboard. Раз порт закрыт снаружи, открывать панель нужно через SSH-туннель. На своём компьютере выполните:

ssh -L 18789:127.0.0.1:18789 имя@адрес_сервера

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

Шаг 5. Проверьте автозапуск после выхода и перезагрузки

Пользовательские службы systemd по умолчанию останавливаются, когда вы выходите из SSH. Чтобы служба работала без открытой сессии и поднималась при загрузке, для пользователя должен быть включён режим lingering. У нас мастер включил его сам и написал об этом: Enabled systemd lingering. Проверьте:

loginctl show-user $(whoami) -p Linger

В ответе должно быть Linger=yes. Если там no, включите вручную, как советует документация:

sudo loginctl enable-linger $(whoami)

Для проверки перезагрузите сервер командой sudo reboot, зайдите снова и выполните openclaw gateway status. У нас после перезагрузки служба поднялась сама, без входа пользователя.

Перезапустить, остановить и снова запустить службу можно так:

openclaw gateway restart
openclaw gateway stop --force
openclaw gateway start

Без флага --force команда остановки у нас отказалась работать и предложила либо тестовый экземпляр, либо этот флаг: так OpenClaw страхует от случайной остановки рабочего агента.

Обновление

Перед крупным обновлением документация советует сделать проверенную резервную копию. Как копировать каталог ~/.openclaw/ и весь сервер, читайте в статье резервные копии VPS.

Порядок из документации:

openclaw update
openclaw doctor
openclaw gateway restart
openclaw health

Первая команда сама определяет тип установки и обновляет программу. Вторая переносит конфигурацию на новую версию и проверяет Gateway. Третья перезапускает службу, четвёртая подтверждает, что всё работает. Посмотреть, что изменится, без установки: openclaw update --dry-run.

Установщик из шага 2 поставил OpenClaw в домашний каталог пользователя, поэтому обновляйте его без sudo. Об этом предупреждает и сам установщик: команда с sudo npm поставит вторую копию в другое место.

Что проверено, а что нет

Проверено на сервере: установщик, первичная настройка с установкой службы, порт 18789 на локальном адресе, lingering, перезагрузка, остановка и запуск службы, панель через SSH-туннель, openclaw health, openclaw doctor и пробный прогон openclaw update --dry-run.

Не проверено: работа агента с подключённой моделью и мессенджерами, настоящее обновление на новую версию (на момент проверки стояла последняя). Официального минимума по процессору и памяти в документации нет: 2 ядра и 4 ГБ остаются нашим ориентиром, основанным на замере памяти выше.

Что делать дальше

Подберите сервер: VPS с 2 ядрами и 4 ГБ. Если планируете запускать модель у себя, а не по API, прочитайте какой сервер нужен для нейросети.