Перед началом установки убедитесь, что у вас есть все необходимое:
📚 Руководство
⚡ Для начинающих
⏱️ 30 минут
Как Установить OpenCLAW на VPS
Пошаговое руководство по установке и настройке OpenCLAW на виртуальном сервере Ubuntu. Все команды готовы к копированию — просто следуйте инструкциям.
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 Anthropic, настройте прокси:
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. Создадим отдельного пользователя user_openclaw.
3.1
Создайте пользователя
bash
adduser user_openclawВас попросят создать пароль и заполнить дополнительную информацию (можно пропустить, нажимая Enter).
3.2
Дайте пользователю права администратора
bash
usermod -aG sudo user_openclaw
3.3
Переключитесь на нового пользователя
bash
su - user_openclaw
Теперь вы работаете от имени пользователя user_openclaw, а не root.
Шаг 4
Установка OpenCLAW
Теперь установим OpenCLAW на ваш сервер.
Запустите скрипт установки
bash
curl -fsSL https://openclaw.ai/install.sh | bash
Шаг 5
Настройка PATH
После установки команда openclaw не будет найдена. Нужно добавить путь в переменную окружения PATH.
5.1
Добавьте путь в .bashrc
bash
echo 'export PATH="/home/user_openclaw/.npm-global/bin:$PATH"' >> ~/.bashrc
Адаптируйте под себя, если вы использовали ДРУГОЕ имя, отличное от
user_openclaw.
5.2
Примените изменения
bash
source ~/.bashrc
5.3
Проверьте установку
bash
which openclaw
Должно вывести путь:
/home/user_openclaw/.npm-global/bin/openclaw
Шаг 6
Автоматический Запуск 24/7
Настроим systemd, чтобы OpenCLAW запускался автоматически при загрузке сервера и работал постоянно.
6.1
Создайте файл службы
Выполните команду (замените user_openclaw на ваше имя пользователя, если использовали другое):
bash
sudo bash -c 'cat > /etc/systemd/system/openclaw-gateway.service << EOF
[Unit]
Description=Openclaw Gateway
After=network-online.target
Wants=network-online.target
[Service]
User=user_openclaw
WorkingDirectory=/home/user_openclaw
Environment=PATH=/home/user_openclaw/.npm-global/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
ExecStart=/home/user_openclaw/.npm-global/bin/openclaw gateway --bind loopback --port 18789 --verbose
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF'
6.2
Активируйте и запустите службу
bash
sudo systemctl daemon-reload
sudo systemctl enable openclaw-gateway.service
sudo systemctl start openclaw-gateway.service
6.3
Проверьте статус
bash
sudo systemctl status openclaw-gateway.service
Должно быть active (running) зелёным цветом.
Шаг 7
Подключение с Локального Компьютера
Откройте НОВОЕ окно терминала на вашем компьютере (не на сервере) и создайте SSH-туннель.
Создайте SSH-туннель
bash
ssh -N -L 18789:127.0.0.1:18789 user_openclaw@YOUR_SERVER_IP
Шаг 8
Справка и Устранение Ошибок
📝 Основные команды
Проверить статус
sudo systemctl status openclaw-gateway.serviceПерезапустить службу
sudo systemctl restart openclaw-gateway.serviceОстановить службу
sudo systemctl stop openclaw-gateway.serviceПросмотр логов
sudo journalctl -u openclaw-gateway.service -f🔧 Устранение типичных ошибок
npm install failed; cleaning up and retrying...
Причина: Конфликт процессов обновления системы или отсутствие npm.
1
Разблокируйте APT
sudo killall unattended-upgr
sudo rm /var/lib/dpkg/lock-frontend /var/lib/apt/lists/lock
sudo dpkg --configure -a
sudo apt update
2
Установите npm
sudo apt install npm -y
npm --version # проверьте, ~10.x
3
Перезапустите установку OpenCLAW
curl -fsSL https://openclaw.ai/install.sh | bash🚀 Хотите готового AI-агента?
Настроим OpenCLAW на вашем сервере за 3 дня — 50 000₽