Перед началом установки убедитесь, что у вас есть все необходимое:
📚 Руководство
⚡ Для начинающих
⏱️ 30 минут
Как Установить OpenCLAW на VPS
Пошаговое руководство по установке и настройке OpenCLAW на виртуальном сервере Ubuntu. Все команды готовы к копированию — просто следуйте инструкциям.
Шаг 1
Что Понадобится
IP-адрес
Вы получите его после создания VPS
Пример: 111.222.33.444Терминал
Terminal (Mac), PowerShell или CMD (Windows)
Для SSH подключения
Совет: Везде, где указано
YOUR_SERVER_IP, замените на ваш реальный IP-адрес сервера (например: 111.222.33.444).
Шаг 2
Подключение к Серверу
На этом этапе вы получите доступ к серверу для начала настройки.
2.1
Подключитесь по SSH
Входим на сервер удалённо через SSH (Secure Shell):
bash
ssh root@YOUR_SERVER_IP
После выполнения команды вас попросят ввести root-пароль сервера. Введите его (символы не отображаются при вводе — это нормально) и нажмите Enter.
2.2
Настройка прокси (опционально)
Если ваш VPS находится в регионе с ограничениями доступа к API, настройте прокси:
bash
bash <(curl -fsSL https://raw.githubusercontent.com/shorin-nikita/squid-proxy/main/install.sh)
Скрипт попросит ввести данные прокси в формате
Пример:
ip:port@login:passwordПример:
209.127.41.191:8000@user:pass
Шаг 3
Создание Нового Пользователя
По соображениям безопасности мы не будем запускать всё от имени root. Создадим отдельного пользователя.
3.1
Создайте пользователя
bash
adduser aibotВас попросят создать пароль и заполнить дополнительную информацию (можно пропустить, нажимая Enter).
3.2
Дайте пользователю права администратора
bash
usermod -aG sudo aibot
3.3
Переключитесь на нового пользователя
bash
su - aibot
Теперь вы работаете от имени пользователя aibot, а не root.
Шаг 4
Защита Сервера
Включим файрвол, чтобы закрыть все порты, кроме SSH.
4.1
Включите файрвол
bash
sudo ufw allow OpenSSH
sudo ufw enable
На вопрос подтверждения введите
y. Это закроет все порты, кроме SSH — ваше соединение не прервётся.
Шаг 5
Установка OpenCLAW
Установим OpenCLAW на сервер. Скрипт автоматически установит Node.js, npm и запустит встроенный wizard для настройки модели, каналов и параметров.
Запустите скрипт установки
bash
curl -fsSL https://openclaw.ai/install.sh | bash
5.1
Настройте PATH (если команда
Настройте PATH (если команда openclaw не найдена)
bash
echo 'export PATH="/home/aibot/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Адаптируйте путь под себя, если вы использовали ДРУГОЕ имя пользователя, отличное от
aibot.
5.2
Проверьте установку
bash
which openclaw
Должно вывести путь:
/home/aibot/.npm-global/bin/openclaw
Шаг 6
Запуск Gateway 24/7
Wizard из шага 5 уже настроил модель, каналы и параметры. Остаётся запустить gateway как системный сервис, чтобы он работал 24/7.
6.1
Переподключитесь напрямую как aibot
Выйдите из su - aibot и подключитесь по SSH напрямую — это нужно для работы systemd user services:
bash
exit # выйти из aibot
exit # выйти из root
ssh aibot@YOUR_SERVER_IP
Это важный шаг! Через
su - aibot systemd user services не работают — нужна прямая SSH-сессия.
6.2
Включите persistence и установите сервис
bash
sudo loginctl enable-linger aibot
openclaw doctor --repairdoctor --repair автоматически создаст и запустит systemd-сервис, исправит конфигурацию.
6.3
Проверьте статус
Подождите 10-15 секунд после запуска, затем:
bash
openclaw gateway status
Должно показать: Service: systemd (enabled), Runtime: running и RPC probe: ok.
6.4
Защитите конфигурацию
bash
chmod 700 ~/.openclaw
chmod 700 ~/.openclaw/credentials
chmod 600 ~/.openclaw/openclaw.jsonВ конфигах хранятся токены и ключи — доступ только для вашего пользователя.
6.5
Проверьте безопасность
bash
openclaw doctor
openclaw security auditЭти команды покажут, если что-то настроено небезопасно.
Шаг 7
Подключение и Панель Управления
Gateway работает на сервере 24/7. Осталось подключить Telegram и получить доступ к панели управления.
7.1
Подключите Telegram
Напишите /start вашему боту в Telegram. Бот покажет код пейринга. Подтвердите его в терминале:
bash
openclaw pairing approve telegram <КОД>
Замените
<КОД> на код из Telegram (например, 9EESQNDC). После этого бот начнёт отвечать.
7.2
Откройте панель управления
bash
openclaw dashboardКоманда покажет ссылку на веб-панель с токеном авторизации. На сервере без GUI скопируйте ссылку и используйте SSH-туннель (шаг 7.3).
7.3
SSH-туннель для удалённого доступа (опционально)
На локальном компьютере откройте новое окно терминала и создайте SSH-туннель:
bash
ssh -N -L 18789:127.0.0.1:18789 aibot@YOUR_SERVER_IPВажно: Замените YOUR_SERVER_IP на IP вашего сервера. Держите окно открытым.
Панель управления будет доступна в браузере: http://127.0.0.1:18789/
Шаг 8
Справка и Устранение Ошибок
📝 Основные команды
Статус сервиса
openclaw gateway statusПерезапуск
openclaw gateway restartОстановка
openclaw gateway stopЛоги в реальном времени
openclaw logs --followДиагностика
openclaw doctorРасширенная проверка
openclaw gateway status --deep🔧 Устранение типичных ошибок
Сервис не устанавливается
Причина: Не выполнен прямой SSH-логин или не включён linger.
1
Переподключитесь напрямую
exit
ssh aibot@YOUR_SERVER_IP
2
Включите linger и восстановите сервис
sudo loginctl enable-linger aibot
openclaw doctor --repairnpm install failed; cleaning up and retrying...
Причина: Конфликт процессов обновления системы или отсутствие npm.
1
Остановите фоновые обновления
sudo systemctl stop unattended-upgrades
sudo apt-get --fix-broken install
sudo apt update
2
Установите npm
sudo apt install npm -y
npm --version
3
Перезапустите установку OpenCLAW
curl -fsSL https://openclaw.ai/install.sh | bash🦁 Хотите разобраться сами?
Вступайте в PrideAI — клуб, где мы вместе строим AI-агентов, делимся опытом и помогаем друг другу