OpenClaw на Timeweb Cloud: пошаговая установка за 10 минут

Обновлено 
OpenClaw на Timeweb Cloud: пошаговая установка за 10 минут

⚙️ Подготовка системы и установка Node.js

Первым шагом после подключения к серверу является обновление системы и установка Node.js. Ubuntu 22.04 и 24.04 LTS поставляются с устаревшими версиями Node.js в официальных репозиториях, поэтому для корректной работы OpenClaw необходимо установить актуальную версию через NodeSource репозиторий.

Выполните следующие команды для обновления системы:

sudo apt update && sudo apt upgrade -y
sudo apt install curl wget gnupg2 software-properties-common -y

Далее добавляем официальный репозиторий NodeSource для Node.js 22 LTS:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install nodejs -y

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

node --version
npm --version

Версия Node.js должна быть 22.16 или выше, а npm — 10.x или выше. Если команды выполняются без ошибок и показывают актуальные версии, можно переходить к следующему этапу.

📦 Загрузка и установка OpenClaw

OpenClaw можно установить двумя способами: через npm как готовый пакет или собрать из исходников с GitHub. Для быстрого развертывания рекомендуется использовать npm-установку, которая займет меньше времени и ресурсов.

Установка через npm:

npm install -g openclaw
mkdir /opt/openclaw && cd /opt/openclaw
openclaw init

Команда openclaw init создаст базовую структуру конфигурационных файлов и покажет пример настроек. Альтернативно, можно клонировать репозиторий для получения последней версии:

cd /opt
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build

Второй способ занимает больше времени (3-5 минут на VPS с одним ядром), но гарантирует получение самой актуальной версии с возможными исправлениями багов.

После установки создайте конфигурационный файл:

cp config.example.json config.json
nano config.json

В конфигурационном файле необходимо указать API-ключи для используемых сервисов. Минимальная конфигурация включает настройки для Telegram бота и OpenAI API. Для тестирования достаточно настроить только Telegram:

{
  "telegram": {
    "token": "YOUR_BOT_TOKEN",
    "enabled": true
  },
  "openai": {
    "apiKey": "YOUR_OPENAI_KEY",
    "model": "gpt-4o-mini"
  },
  "server": {
    "port": 3000,
    "host": "0.0.0.0"
  }
}

🔑 Настройка Telegram бота и API ключей

Для работы с Telegram необходимо создать бота через @BotFather. Отправьте команду /newbot боту @BotFather в Telegram, следуйте инструкциям для выбора имени и username. После создания вы получите токен в формате 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

Скопируйте этот токен в конфигурационный файл OpenClaw в поле telegram.token. Убедитесь, что параметр telegram.enabled установлен в true.

Настройка OpenAI API:

Получите API ключ в личном кабинете OpenAI (platform.openai.com). Для экономии рекомендуется использовать модель gpt-4o-mini, которая обеспечивает хорошее качество ответов при низкой стоимости. Вставьте ключ в поле openai.apiKey.

Для тестирования запустите OpenClaw в режиме отладки:

cd /opt/openclaw
npm start

Если настройка выполнена корректно, в логах появятся сообщения об успешном подключении к Telegram API и готовности к обработке сообщений.

🚀 Автоматический запуск через systemd

Для обеспечения автоматического запуска OpenClaw после перезагрузки сервера необходимо создать systemd сервис. Создайте файл сервиса:

sudo nano /etc/systemd/system/openclaw.service

Вставьте следующую конфигурацию:

[Unit]
Description=OpenClaw AI Agent
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=always
RestartSec=1
User=root
WorkingDirectory=/opt/openclaw
ExecStart=/usr/bin/node index.js
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

Активируйте и запустите сервис:

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

Проверьте статус сервиса:

sudo systemctl status openclaw

Сервис должен показывать статус "active (running)". Для просмотра логов используйте:

sudo journalctl -u openclaw -f

Теперь OpenClaw будет автоматически запускаться при загрузке сервера и перезапускаться в случае сбоев.

🔧 Типичные ошибки и способы их устранения

❌ Ошибка "node: command not found" — чаще всего возникает при некорректной установке Node.js или проблемах с PATH. Решение: переустановите Node.js через NodeSource репозиторий, как описано выше, и убедитесь, что /usr/bin присутствует в переменной PATH.

🌐 Ошибка "ECONNREFUSED" при подключении к Telegram — указывает на проблемы с сетевым подключением или неверный токен бота. Проверьте правильность токена, убедитесь, что firewall не блокирует исходящие соединения на порт 443, и проверьте интернет-соединение сервера командой ping api.telegram.org.

💾 Ошибка "insufficient memory" или высокое потребление RAM — возникает на VPS с 1 ГБ памяти при высокой нагрузке. Решение: добавьте swap-файл размером 2 ГБ командой sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile или обновите тариф до конфигурации с большим объемом RAM.

⚡ Сервис не запускается автоматически — проверьте статус systemd сервиса командой sudo systemctl status openclaw. Часто проблема в неправильных путях в файле сервиса или отсутствии прав доступа. Убедитесь, что путь к Node.js указан корректно (найти можно командой which node) и что пользователь имеет права на чтение файлов OpenClaw.

🔒 Проблемы с SSL сертификатами — могут возникать при подключении к внешним API. Обновите сертификаты командой sudo apt update && sudo apt install ca-certificates и перезапустите сервис.

❓ Часто задаваемые вопросы

💾 Сколько памяти потребляет OpenClaw в режиме 24/7?
В среднем OpenClaw потребляет 150-300 МБ оперативной памяти в зависимости от количества подключенных платформ и активности. На VPS с 2 ГБ RAM система работает комфортно даже при обработке 200-300 сообщений в день. Пиковое потребление может достигать 500 МБ при одновременной обработке множества запросов.

🔄 Можно ли запустить несколько экземпляров OpenClaw на одном сервере?
Да, это возможно при условии использования разных портов и конфигурационных файлов. Создайте отдельные директории для каждого экземпляра, настройте уникальные порты (например, 3000, 3001, 3002) и создайте отдельные systemd сервисы. Для VPS с 4 ГБ RAM можно комфортно запустить 3-4 экземпляра.

🔄 Как обновить OpenClaw до новой версии?
При установке через npm выполните npm update -g openclaw, при установке из исходников — git pull && npm install && npm run build. После обновления перезапустите сервис командой sudo systemctl restart openclaw. Рекомендуется создать резервную копию конфигурационных файлов перед обновлением.

📋 Чеклист быстрой установки

  • ☁️ Создан VPS на Timeweb Cloud с Ubuntu 22.04/24.04
  • 🔗 Выполнено SSH подключение к серверу
  • ⚙️ Установлен Node.js 22+ через NodeSource
  • 📦 Загружен и установлен OpenClaw
  • 🤖 Создан Telegram бот через @BotFather
  • 🔑 Получен OpenAI API ключ
  • ⚙️ Настроен конфигурационный файл config.json
  • 🚀 Создан systemd сервис для автозапуска
  • ✅ Проверена работа через тестовое сообщение боту
  • 📊 Настроены логи для мониторинга работы

После выполнения всех пунктов OpenClaw готов к продуктивной работе на Timeweb Cloud. Система будет автоматически запускаться после перезагрузки сервера и обрабатывать входящие сообщения круглосуточно.

Готовы развернуть собственного AI-агента на Timeweb Cloud? Присоединяйтесь к нашему Telegram-каналу для получения дополнительных инструкций и обсуждения вопросов по настройке: @aaakalsin