English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Hosting

Середовище виконання віртуальної машини Docker

Спільні кроки runtime для встановлень Docker на базі VM, як-от GCP, Hetzner і подібних VPS-провайдерів.

Вбудуйте потрібні бінарні файли в образ

Встановлення бінарних файлів усередині запущеного контейнера — пастка. Усе, що встановлено під час runtime, буде втрачено після перезапуску.

Усі зовнішні бінарні файли, потрібні для Skills, мають бути встановлені під час збирання образу.

Наведені нижче приклади показують лише три поширені бінарні файли:

  • gog (з gogcli) для доступу до Gmail
  • goplaces для Google Places
  • wacli для WhatsApp

Це приклади, а не повний список. Ви можете встановити стільки бінарних файлів, скільки потрібно, використовуючи той самий шаблон.

Якщо згодом ви додасте нові Skills, які залежать від додаткових бінарних файлів, потрібно:

  1. Оновити Dockerfile
  2. Перезібрати образ
  3. Перезапустити контейнери

Приклад Dockerfile

FROM node:24-bookworm

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

# Example binary 1: Gmail CLI (gogcli — installs as `gog`)
# Copy the current Linux asset URL from https://github.com/steipete/gogcli/releases
RUN curl -L https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz \
  | tar -xzO gog > /usr/local/bin/gog; \
  chmod +x /usr/local/bin/gog

# Example binary 2: Google Places CLI
# Copy the current Linux asset URL from https://github.com/steipete/goplaces/releases
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_linux_amd64.tar.gz \
  | tar -xzO goplaces > /usr/local/bin/goplaces; \
  chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
# Copy the current Linux asset URL from https://github.com/steipete/wacli/releases
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli-linux-amd64.tar.gz \
  | tar -xzO wacli > /usr/local/bin/wacli; \
  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"]

Збирання та запуск

docker compose build
docker compose up -d openclaw-gateway

Якщо збирання завершується помилкою Killed або exit code 137 під час pnpm install --frozen-lockfile, VM бракує пам’яті. Використайте більший клас машини перед повторною спробою.

Перевірте бінарні файли:

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

Перевірте Gateway:

docker compose logs -f openclaw-gateway

Очікуваний вивід:

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

Що де зберігається

OpenClaw працює в Docker, але Docker не є джерелом істини. Увесь довготривалий стан має переживати перезапуски, перезбирання та перезавантаження.

Компонент Розташування Механізм збереження Примітки
Конфігурація Gateway /home/node/.openclaw/ Монтування тому хоста Містить openclaw.json, .env
Профілі автентифікації моделей /home/node/.openclaw/agents/ Монтування тому хоста agents/<agentId>/agent/auth-profiles.json (OAuth, ключі API)
Конфігурації Skills /home/node/.openclaw/skills/ Монтування тому хоста Стан рівня Skills
Робочий простір агента /home/node/.openclaw/workspace/ Монтування тому хоста Код і артефакти агентів
Сесія WhatsApp /home/node/.openclaw/ Монтування тому хоста Зберігає QR-вхід
Сховище ключів Gmail /home/node/.openclaw/ Том хоста + пароль Потребує GOG_KEYRING_PASSWORD
Пакети Plugin /home/node/.openclaw/npm, /home/node/.openclaw/git Монтування тому хоста Корені пакетів Plugin, доступних для завантаження
Зовнішні бінарні файли /usr/local/bin/ Образ Docker Мають бути вбудовані під час збирання
Runtime Node Файлова система контейнера Образ Docker Перезбирається під час кожного збирання образу
Пакети ОС Файлова система контейнера Образ Docker Не встановлюйте під час runtime
Контейнер Docker Тимчасовий Можна перезапускати Безпечно знищувати

Оновлення

Щоб оновити OpenClaw на VM:

git pull
docker compose build
docker compose up -d

Пов’язане