OpenClaw на Hetzner (Docker, руководство для production VPS)

Цель

Запустить постоянный OpenClaw Gateway на VPS Hetzner с использованием Docker, с устойчивым состоянием, встроенными бинарниками и безопасным поведением при перезапуске. Если вам нужен «OpenClaw 24/7 примерно за ~$5», это самая простая надёжная настройка. Цены Hetzner меняются; выберите самый маленький VPS с Debian/Ubuntu и масштабируйтесь, если столкнётесь с OOM.

Что мы делаем (простыми словами)?

Арендуем небольшой Linux-сервер (VPS Hetzner)
Устанавливаем Docker (изолированная среда выполнения приложений)
Запускаем OpenClaw Gateway в Docker
Сохраняем ~/.openclaw + ~/.openclaw/workspace на хосте (переживает перезапуски/пересборки)
Получаем доступ к Control UI с ноутбука через SSH-туннель

Доступ к Gateway возможен через:

Проброс портов SSH с вашего ноутбука
Прямое открытие порта, если вы самостоятельно управляете файрволом и токенами

Это руководство предполагает Ubuntu или Debian на Hetzner.
Если у вас другой Linux VPS, сопоставьте пакеты соответствующим образом. Для общего Docker-потока см. Docker.

Быстрый путь (для опытных операторов)

Подготовить VPS Hetzner
Установить Docker
Клонировать репозиторий OpenClaw
Создать постоянные каталоги на хосте
Настроить .env и docker-compose.yml
Встроить необходимые бинарники в образ
docker compose up -d
Проверить сохранность данных и доступ к Gateway

Что вам понадобится

VPS Hetzner с root-доступом
SSH-доступ с вашего ноутбука
Базовое владение SSH + копированием/вставкой
~20 минут
Docker и Docker Compose
Учётные данные аутентификации модели
Необязательные учетные данные поставщика
- QR для WhatsApp
- Токен бота Telegram
- OAuth Gmail

1. Подготовка VPS

Создайте VPS с Ubuntu или Debian в Hetzner. Подключитесь как root:

ssh root@YOUR_VPS_IP

Это руководство предполагает, что VPS является состоянием. Не рассматривайте его как одноразовую инфраструктуру.

2. Установка Docker (на VPS)

apt-get update
apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sh

Проверьте:

docker --version
docker compose version

3. Клонирование репозитория OpenClaw

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Это руководство предполагает, что вы будете собирать кастомный образ для гарантии сохранности бинарников.

4. Создание постоянных каталогов на хосте

Docker-контейнеры эфемерны. Все долгоживущее состояние должно храниться на хосте.

mkdir -p /root/.openclaw/workspace

# Set ownership to the container user (uid 1000):
chown -R 1000:1000 /root/.openclaw

5. Настройка переменных окружения

Создайте .env в корне репозитория.

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=change-me-now
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/root/.openclaw
OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace

GOG_KEYRING_PASSWORD=change-me-now
XDG_CONFIG_HOME=/home/node/.openclaw

Сгенерируйте надёжные секреты:

openssl rand -hex 32

Не коммитьте этот файл.

6. Конфигурация Docker Compose

Создайте или обновите docker-compose.yml.

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - TERM=xterm-256color
      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      # Recommended: keep the Gateway loopback-only on the VPS; access via SSH tunnel.
      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"

      # Optional: only if you run iOS/Android nodes against this VPS and need Canvas host.
      # If you expose this publicly, read /gateway/security and firewall accordingly.
      # - "18793:18793"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
        "--allow-unconfigured",
      ]

--allow-unconfigured предназначен только для удобства начальной настройки и не является заменой корректной конфигурации шлюза. Обязательно настройте аутентификацию (gateway.auth.token или пароль) и используйте безопасные параметры привязки для вашего развертывания.

7. Встраивание необходимых бинарников в образ (критично)

Установка бинарников внутри запущенного контейнера — ловушка. Всё, что установлено во время выполнения, будет потеряно при перезапуске. Все внешние бинарники, необходимые Skills, должны устанавливаться на этапе сборки образа. Примеры ниже показывают только три распространённых бинарника:

gog для доступа к Gmail
goplaces для Google Places
wacli для WhatsApp

Это примеры, а не полный список. Вы можете устанавливать столько бинарников, сколько нужно, используя тот же шаблон. Если позже вы добавите новые Skills, зависящие от дополнительных бинарников, необходимо:

Обновить Dockerfile
Пересобрать образ
Перезапустить контейнеры

Пример Dockerfile

FROM node:22-bookworm

RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*

# Example binary 1: Gmail CLI
RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/gog

# Example binary 2: Google Places CLI
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/wacli

# Add more binaries below using the same pattern

WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

RUN corepack enable
RUN pnpm install --frozen-lockfile

COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

ENV NODE_ENV=production

CMD ["node","dist/index.js"]

8. Сборка и запуск

docker compose build
docker compose up -d openclaw-gateway

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

docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli

Ожидаемый вывод:

/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli

9. Проверка Gateway

docker compose logs -f openclaw-gateway

Успех:

[gateway] listening on ws://0.0.0.0:18789

С вашего ноутбука:

ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP

Откройте: http://127.0.0.1:18789/ Вставьте токен вашего Gateway.

Что и где сохраняется (источник истины)

OpenClaw работает в Docker, но Docker не является источником истины. Всё долгоживущее состояние должно переживать перезапуски, пересборки и перезагрузки.

Компонент	Расположение	Механизм сохранности	Примечания
Конфигурация Gateway	`/home/node/.openclaw/`	Монтирование тома хоста	Включает `openclaw.json`, токены
Профили аутентификации моделей	`/home/node/.openclaw/`	Монтирование тома хоста	OAuth-токены, ключи API
Конфиги Skills	`/home/node/.openclaw/skills/`	Монтирование тома хоста	Состояние на уровне Skills
Рабочее пространство агента	`/home/node/.openclaw/workspace/`	Монтирование тома хоста	Код и артефакты агента
Сеанс WhatsApp	`/home/node/.openclaw/`	Монтирование тома хоста	Сохраняет вход по QR
Хранилище ключей Gmail	`/home/node/.openclaw/`	Том хоста + пароль	Требуется `GOG_KEYRING_PASSWORD`
Внешние бинарники	`/usr/local/bin/`	Docker-образ	Должен быть испечен во время сборки
Среда выполнения Node	Файловая система контейнера	Docker-образ	Восстановить все изображения
Пакеты ОС	Файловая система контейнера	Docker-образ	Не устанавливать во время выполнения
Docker-контейнер	Эфемерный	Перезапускаемый	Безопасно удалять

Инфраструктура как код (Terraform)

Для команд, предпочитающих процессы инфраструктуры как кода, поддерживаемая сообществом конфигурация Terraform предоставляет:

Модульную конфигурацию Terraform с удалённым управлением состоянием
Автоматическое развертывание через cloud-init
Скрипты развертывания (bootstrap, deploy, backup/restore)
Усиленную безопасность (firewall, UFW, доступ только по SSH)
Настройку SSH-туннеля для доступа к gateway

Репозитории:

Инфраструктура: openclaw-terraform-hetzner
Конфигурация Docker: openclaw-docker-config

Этот подход дополняет описанную выше настройку Docker воспроизводимыми развертываниями, инфраструктурой с контролем версий и автоматическим восстановлением после сбоев.

Примечание: Поддерживается сообществом. По вопросам и предложениям см. ссылки на репозитории выше.

Обзор установки

Другие способы установки

Обслуживание

Хостинг и развертывание

Расширенные

Hetzner

OpenClaw на Hetzner (Docker, руководство для production VPS)

Цель

Что мы делаем (простыми словами)?

Быстрый путь (для опытных операторов)

Что вам понадобится

1. Подготовка VPS

2. Установка Docker (на VPS)

3. Клонирование репозитория OpenClaw

4. Создание постоянных каталогов на хосте

5. Настройка переменных окружения

6. Конфигурация Docker Compose

7. Встраивание необходимых бинарников в образ (критично)

8. Сборка и запуск

9. Проверка Gateway

Что и где сохраняется (источник истины)

Инфраструктура как код (Terraform)

​OpenClaw на Hetzner (Docker, руководство для production VPS)

​Цель

​Что мы делаем (простыми словами)?

​Быстрый путь (для опытных операторов)

​Что вам понадобится

​1. Подготовка VPS

​2. Установка Docker (на VPS)

​3. Клонирование репозитория OpenClaw

​4. Создание постоянных каталогов на хосте

​5. Настройка переменных окружения

​6. Конфигурация Docker Compose

​7. Встраивание необходимых бинарников в образ (критично)

​8. Сборка и запуск

​9. Проверка Gateway

​Что и где сохраняется (источник истины)

​Инфраструктура как код (Terraform)

OpenClaw на Hetzner (Docker, руководство для production VPS)

Цель

Что мы делаем (простыми словами)?

Быстрый путь (для опытных операторов)

Что вам понадобится

1. Подготовка VPS

2. Установка Docker (на VPS)

3. Клонирование репозитория OpenClaw

4. Создание постоянных каталогов на хосте

5. Настройка переменных окружения

6. Конфигурация Docker Compose

7. Встраивание необходимых бинарников в образ (критично)

8. Сборка и запуск

9. Проверка Gateway

Что и где сохраняется (источник истины)

Инфраструктура как код (Terraform)