Установка на VPS и сервер

OpenClaw можно запустить на любом Linux-сервере или VPS. Это значит, что ваш AI-ассистент работает 24/7, доступен из любого места и не зависит от вашего ноутбука.

Как это работает

  • Gateway запускается на сервере и хранит все данные (конфигурацию, сессии, файлы)
  • Вы подключаетесь через Control UI в браузере или через SSH/Tailscale
  • Сервер — источник правды. Регулярно делайте бэкапы папки ~/.openclaw/
  • Доступ к Gateway:

  • Локально: http://127.0.0.1:18789/
  • Удалённо: SSH-туннель или Tailscale Serve (рекомендуется)
  • Если привязываете к lan или tailnet — обязательно настройте токен авторизации
  • Подробнее: Удалённый доступ, Tailscale

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

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

    AWS (EC2 / Lightsail / free tier) тоже подходит.

    Установка на VPS

    Самый простой способ — установочный скрипт:

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

    Скрипт сам установит Node.js (если нужно) и запустит онбординг. После настройки Gateway запустится как systemd-сервис.

    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
    

    Управление каналами через 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` Предустановить плагины при сборке
    `OPENCLAW_EXTRA_MOUNTS` Доп. хост-тома (`source:target[:opts]`, через запятую)
    `OPENCLAW_HOME_VOLUME` Сохранять `/home/node` в Docker volume
    `OPENCLAW_SANDBOX` Включить sandbox (`1`, `true`, `yes`)
    `OPENCLAW_DOCKER_SOCKET` Путь к Docker socket
    `OPENCLAW_DISABLE_BONJOUR` Отключить Bonjour/mDNS (по умолчанию `1` для Docker)

    LAN vs loopback

  • lan (по умолчанию для Docker): хост и CLI обращаются к Gateway через опубликованный порт
  • loopback: Gateway доступен только внутри контейнерной сети
  • Для публичного доступа используйте lan + токен авторизации. Для безопасности — loopback + SSH-туннель.

    Host local providers

    Когда OpenClaw работает в Docker, 127.0.0.1 — это контейнер, а не хост. Для Ollama и LM Studio на хосте используйте host.docker.internal:

    Провайдер URL на хосте URL в Docker
    LM Studio `http://127.0.0.1:1234` `http://host.docker.internal:1234`
    Ollama `http://127.0.0.1:11434` `http://host.docker.internal:11434`

    Ручной flow (без setup.sh)

    Если хотите контролировать каждый шаг:

    docker build -t openclaw:local -f Dockerfile .
    docker compose run --rm --no-deps --entrypoint node openclaw-gateway \
      dist/index.js onboard --mode local --no-install-daemon
    docker compose up -d openclaw-gateway
    

    Оптимизация для слабых серверов

    Если сервер маломощный (ARM, 1-2 ГБ RAM), ускорьте запуск:

    cat >> ~/.bashrc 

    Для systemd-сервиса:

    systemctl --user edit openclaw-gateway.service
    

    Добавьте:

    [Service]
    Environment=OPENCLAW_NO_RESPAWN=1
    Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
    Restart=always
    RestartSec=2
    TimeoutStartSec=90
    

    Ноды с VPS

    Можно держать Gateway в облаке, а локальные устройства (Mac, iPhone, Android) подключать как ноды. Ноды обеспечивают доступ к камере, микрофону, экрану, геолокации и Canvas, пока Gateway работает на сервере.

    Подробнее: Ноды

    Проверка здоровья

    curl -fsS http://127.0.0.1:18789/healthz   # liveness
    curl -fsS http://127.0.0.1:18789/readyz     # readiness
    

    Что дальше

  • Конфигурация Gateway — настроить модели и каналы
  • Удалённый доступ — SSH и Tailscale
  • Безопасность — защита публичного сервера