OpenClaw можно установить на обычный Linux VPS и использовать как постоянный сервис для работы через Gateway. Для сервера самый практичный вариант — Debian 12, Node.js 24 и запуск через официальный onboarding. Такой путь проще в поддержке, стабильнее на VPS и даёт меньше проблем при обновлениях.

Этот гайд подходит для тех, кому нужен рабочий запуск OpenClaw на VPS, а не просто формальная установка пакета. Здесь учтены частые проблемы на headless-серверах: ошибки с systemctl --user, отсутствие user session bus, конфликт версий CLI и Gateway, а также безопасный доступ к интерфейсу без публикации порта в интернет.

Если вы оплачиваете сервер на год, мы установим и настроим OpenClaw бесплатно.

Что нужно перед установкой

• VPS с Debian 12
• доступ по SSH
• пользователь с правами sudo или root
• API-ключ провайдера модели, который вы будете использовать в OpenClaw

Для Linux лучше сразу использовать Node.js, а не экспериментировать с лишними runtime-сценариями. На VPS это самый предсказуемый путь.

Шаг 1. Подключитесь к серверу

ssh root@YOUR_SERVER_IP

Если вы работаете не из-под root, сначала подключитесь обычным пользователем и используйте sudo там, где это требуется.

Шаг 2. Установите OpenClaw

Самый простой способ — официальный installer:

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

Если хотите сначала поставить OpenClaw без немедленного onboarding:

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

Если installer по какой-то причине не подходит, используйте ручной путь через npm:

npm install -g openclaw@latest

Не смешивайте несколько способов установки на одном сервере. Если вы сначала ставили OpenClaw через один путь, а потом через другой, это часто приводит к путанице между CLI и Gateway.

Шаг 3. Запустите первичную настройку

openclaw onboard --install-daemon

Во время onboarding OpenClaw предложит выбрать модель, указать API-ключ и настроить Gateway.

После завершения проверьте статус:

openclaw gateway status
openclaw status

Шаг 4. Подключитесь к Gateway безопасно

На VPS не стоит сразу открывать Gateway наружу в интернет. Безопаснее подключаться к нему через SSH-туннель с вашего компьютера.

На локальном компьютере выполните:

ssh -N -L 18789:127.0.0.1:18789 user@YOUR_SERVER_IP

После этого откройте в браузере:

http://127.0.0.1:18789/

Такой вариант безопаснее и проще в поддержке, чем немедленная публикация порта на сервере.

Как проверить, что OpenClaw действительно работает

Сначала проверьте версии:

openclaw --version
node -v

Потом проверьте состояние Gateway:

openclaw gateway status
openclaw status --all

Если хотите посмотреть логи в реальном времени:

openclaw logs --follow

Если стандартный вывод не помогает, откройте последний лог напрямую:

tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

Порт Gateway можно проверить отдельно:

ss -ltnp | grep 18789

Если всё в порядке, вы увидите слушающий порт 127.0.0.1:18789 или активный процесс OpenClaw.

Частая проблема №1: ошибка systemctl --user unavailable

На headless VPS OpenClaw может уткнуться в ошибку вида:

systemctl --user unavailable
Failed to connect to bus
No medium found

Это типичная проблема user-level systemd на сервере без нормальной пользовательской сессии.

Исправление:

sudo loginctl enable-linger $(whoami)
echo 'export XDG_RUNTIME_DIR=/run/user/$(id -u)' >> ~/.bashrc
source ~/.bashrc
openclaw gateway install --force

После этого снова проверьте:

openclaw gateway status

Если вы запускаете OpenClaw под root, именно здесь чаще всего всё и ломается. Это не баг вашего сервера как такового, а обычная проблема headless Linux-среды.

Частая проблема №2: Gateway не отвечает после установки

Если onboarding завершился, но интерфейс не открывается, проверьте:

openclaw gateway status
openclaw logs --follow
ss -ltnp | grep 18789

Если сервис завис или остался stale process, перезапустите его:

systemctl --user stop openclaw-gateway.service
pkill -f openclaw || true
systemctl --user start openclaw-gateway.service

Потом снова:

openclaw gateway status

Частая проблема №3: CLI и Gateway работают на разных версиях

Это одна из самых неприятных ситуаций. Команда openclaw в shell может идти из старого пути, а Gateway-сервис — из другого. Тогда диагностика становится кривой: в одном месте вы видите одну версию, в другом другую.

Проверьте:

which openclaw
openclaw --version
systemctl --user cat openclaw-gateway.service

Если пути отличаются, удалите старую установку и оставьте только один актуальный install path. После этого заново выполните:

npm install -g openclaw@latest
openclaw gateway install --force
openclaw gateway status

Частая проблема №4: OpenClaw поставили, но доступ к интерфейсу всё равно не работает

Здесь обычно одна из трёх причин:

• Gateway не поднялся и порт 18789 не слушается
• вы открываете не через SSH-туннель, а пытаетесь зайти напрямую
• настройка авторизации не завершена во время onboarding

Проверьте базовый сценарий ещё раз:

openclaw gateway status
ss -ltnp | grep 18789

Потом с локальной машины:

ssh -N -L 18789:127.0.0.1:18789 user@YOUR_SERVER_IP

И только после этого открывайте:

http://127.0.0.1:18789/

Что лучше не делать на VPS

• не смешивать installer и несколько разных глобальных установок
• не обновлять OpenClaw хаотично через разные Node path
• не открывать Gateway напрямую в интернет без защиты
• не игнорировать ошибки с systemctl --user и XDG_RUNTIME_DIR
• не пытаться чинить проблему только переустановкой, если сломан сам service path

Быстрая установка OpenClaw на Debian 12

Если нужен короткий рабочий сценарий без лишней теории:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status

С локального компьютера:

ssh -N -L 18789:127.0.0.1:18789 user@YOUR_SERVER_IP

Открыть в браузере:

http://127.0.0.1:18789/

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

Если вы не хотите тратить время на разбор ошибок, user systemd, логи и проверку Gateway, мы можем установить и настроить OpenClaw за вас.

При оплате сервера на год установка и базовая настройка выполняются бесплатно.

Если OpenClaw уже установлен, но не запускается корректно, мы также можем помочь с диагностикой, исправлением service path, проверкой Node runtime и безопасным запуском Gateway на VPS.