Установка OpenClaw на VPS: пошаговое руководство для начинающих

OpenClaw — это self-hosted шлюз, который связывает ваши мессенджеры с ИИ-агентом. Установка на VPS даёт доступ к ассистенту 24/7 из любого места. В статье — пошаговая инструкция от выбора сервера до первого запуска, включая установку через скрипт и Docker.

Что такое OpenClaw и зачем ставить на VPS

OpenClaw — open-source проект (лицензия MIT), который превращает любой сервер в мост между вашими мессенджерами (Telegram, Discord, WhatsApp, Signal, Slack) и ИИ-агентом. Один процесс Gateway обрабатывает все каналы одновременно.

Зачем именно VPS, а не домашний компьютер:

  • Доступность — агент работает круглосуточно, даже когда ваш ноутбук выключен
  • Стабильное соединение — сервер в дата-центре, а не домашний интернет с перебоями
  • Удалённый доступ — через SSH, Tailscale или Control UI в браузере
  • Мобильные ноды — iOS и Android устройства подключаются к серверу как ноды (камера, геолокация, голос)
  • Требования

    Для работы OpenClaw на VPS потребуется:

  • Операционная система — Linux (Ubuntu, Debian и другие), macOS или Windows
  • Node.js — версия 24 (рекомендуется) или 22.14+. Установочный скрипт ставит автоматически
  • API-ключ — от одного из провайдеров: OpenAI, Anthropic, Google Gemini, DeepSeek, OpenRouter, Mistral, Groq, Ollama и ещё 35+ вариантов
  • 5 минут на установку
  • Для начала рекомендуем Google Gemini или OpenRouter — у них есть бесплатный тир для тестирования.

    Выбор хостинга

    OpenClaw работает на любом Linux-сервере. Вот проверенные варианты:

    Провайдер Особенности Бесплатный тир
    Oracle Cloud Always Free ARM-инстансы Да
    Northflank One-click, браузерная настройка Да
    Fly.io Fly Machines Да
    GCP Compute Engine Да
    Azure Linux VM Да
    DigitalOcean Простой платный VPS Нет
    Hetzner Docker на VPS Нет
    Hostinger VPS с one-click Нет
    Railway One-click, браузерная настройка Нет

    AWS (EC2, Lightsail, free tier) тоже подходит. Можно использовать даже Raspberry Pi.

    Если бюджет ограничен — Oracle Cloud Always Free: ARM-инстанс с 24 ГБ RAM и 4 ядрами бесплатно навсегда.

    Шаг 1: Установка OpenClaw

    Быстрый способ (рекомендуется)

    Одна команда — скрипт сам определит ОС, установит Node.js (если нужно), установит OpenClaw и запустит мастер настройки:

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

    Для Windows (PowerShell):

    iwr -useb https://openclaw.ai/install.ps1 | iex
    

    Через Docker

    Если предпочитаете контейнеры:

    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    ./scripts/docker/setup.sh
    

    Скрипт соберёт образ, запустит онбординг и поднимет Gateway через Docker Compose.

    Чтобы использовать готовый образ вместо сборки:

    export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
    ./scripts/docker/setup.sh
    

    Шаг 2: Настройка (онбординг)

    После установки запустится мастер настройки. Если нужно запустить вручную:

    openclaw onboard --install-daemon
    

    Мастер проведёт через несколько шагов (примерно 2 минуты):

  • Выбор модели — какой ИИ-провайдер будет работать. Введите API-ключ от выбранного сервиса
  • Рабочее пространство — где хранятся файлы агента (по умолчанию ~/.openclaw/workspace)
  • Gateway — настройки порта и авторизации (обычно достаточно значений по умолчанию — порт 18789)
  • Каналы — подключение мессенджеров. Можно пропустить и настроить позже
  • Служба — установка автозапуска (systemd на Linux, LaunchAgent на macOS)
  • При первом запуске агент автоматически:

  • Создаст файлы AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md в рабочем пространстве
  • Запустит короткий опрос — узнает ваше имя и предпочтения
  • Запишет ответы в файлы конфигурации
  • Удалит BOOTSTRAP.md — опрос запускается только один раз
  • Шаг 3: Проверка

    Проверяем, что Gateway запустился:

    openclaw gateway status
    

    Должно быть видно, что Gateway слушает порт 18789.

    Откройте дашборд:

    openclaw dashboard
    

    Или в браузере: http://127.0.0.1:18789/. Если страница загрузилась — всё работает.

    Полная диагностика:

    openclaw status          # локальный статус
    openclaw status --all    # полный отчёт
    openclaw health --json   # здоровье Gateway
    

    Логи лежат в /tmp/openclaw/ (файл openclaw-YYYY-MM-DD.log).

    Управление через Docker

    Если установили через Docker, каналы добавляются отдельно:

    # Telegram
    docker compose run --rm openclaw-cli channels add --channel telegram --token "ВАШ_ТОКЕН"
    
    # Discord
    docker compose run --rm openclaw-cli channels add --channel discord --token "ВАШ_ТОКЕН"
    
    # WhatsApp (QR-код)
    docker compose run --rm openclaw-cli channels login
    

    Полезные переменные окружения для Docker:

    Переменная Назначение
    `OPENCLAW_IMAGE` Использовать готовый образ вместо сборки
    `OPENCLAW_DOCKER_APT_PACKAGES` Доп. пакеты при сборке (через пробел)
    `OPENCLAW_EXTENSIONS` Предустановить плагины при сборке

    Удалённый доступ к серверу

    По умолчанию Gateway доступен только локально (http://127.0.0.1:18789/). Для удалённого доступа:

  • SSH-туннельssh -L 18789:localhost:18789 user@server
  • Tailscale Serve — рекомендуемый способ, автоматический HTTPS
  • Привязка к lan или tailnet — если привязываете, обязательно настройте токен авторизации
  • Конфигурация

    Конфигурация хранится в ~/.openclaw/openclaw.json. Формат — JSON5 (поддерживает комментарии и trailing commas).

    Способы редактирования:

  • Интерактивный мастер: openclaw configure
  • CLI: openclaw config set agents.defaults.heartbeat.every "2h"
  • Control UI: откройте http://127.0.0.1:18789 → вкладка Config
  • Прямое редактирование: измените файл — Gateway применяет изменения автоматически (hot reload)
  • Минимальный конфиг:

    {
      agents: { defaults: { workspace: "~/.openclaw/workspace" } },
      channels: { whatsapp: { allowFrom: ["+79001234567"] } },
    }
    

    Бэкапы

    Сервер — источник правды. Все данные (конфигурация, сессии, файлы) хранятся в ~/.openclaw/. Регулярно делайте бэкапы этой папки.

    Что умеет OpenClaw после установки

  • Мультиканальность — Discord, Telegram, WhatsApp, Signal, Slack, iMessage, WebChat и 15+ каналов через плагины
  • Агент с инструментами — выполняет код, открывает браузер, ищет в интернете, работает с файлами, генерирует изображения
  • 35+ провайдеров — OpenAI, Anthropic, Google, DeepSeek, Mistral, Groq, Ollama (локально), OpenRouter, xAI, Xiaomi MiMo
  • Мультиагентность — несколько агентов с разными моделями и правами
  • Мобильные ноды — iOS и Android подключаются как ноды (камера, микрофон, геолокация)
  • Веб-интерфейс — Control UI для чата, настройки, сессий и нод
  • Ссылки

  • Что такое OpenClaw — обзор возможностей
  • Установка OpenClaw — подробная инструкция
  • Установка на VPS и сервер — специфика для серверов
  • Первая настройка OpenClaw — что делать после установки
  • FAQ и решение проблем — ответы на частые вопросы