OpenClawDocs
На этой странице

На этой странице

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

Среда выполнения Docker в виртуальной машине

Общие шаги настройки среды выполнения для установки Docker на виртуальных машинах, например у GCP, Hetzner и аналогичных поставщиков VPS.

Включение необходимых исполняемых файлов в образ

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

В примерах ниже рассматриваются только три исполняемых файла в алфавитном порядке:

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

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

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

Пример Dockerfile

dockerfile
FROM node:24-bookworm RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/* # Пример исполняемого файла 1: CLI для Gmail (gogcli — устанавливается как `gog`)# Скопируйте URL-адрес актуального ресурса для Linux со страницы https://github.com/steipete/gogcli/releasesRUN 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 # Пример исполняемого файла 2: CLI для Google Places# Скопируйте URL-адрес актуального ресурса для Linux со страницы https://github.com/steipete/goplaces/releasesRUN 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 # Пример исполняемого файла 3: CLI для WhatsApp# Скопируйте URL-адрес актуального ресурса для Linux со страницы https://github.com/steipete/wacli/releasesRUN 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 # Добавьте ниже другие исполняемые файлы по той же схеме WORKDIR /appCOPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./COPY ui/package.json ./ui/package.jsonCOPY scripts ./scripts RUN corepack enableRUN pnpm install --frozen-lockfile COPY . .RUN pnpm buildRUN pnpm ui:installRUN pnpm ui:build ENV NODE_ENV=production CMD ["node","dist/index.js"]

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

bash
docker compose builddocker compose up -d openclaw-gateway

Если во время pnpm install --frozen-lockfile сборка завершается ошибкой Killed или с кодом выхода 137, виртуальной машине не хватает памяти. Перед повторной попыткой выберите класс машины с большим объёмом памяти.

Проверьте исполняемые файлы:

bash
docker compose exec openclaw-gateway which gogdocker compose exec openclaw-gateway which goplacesdocker compose exec openclaw-gateway which wacli

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

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

Убедитесь, что Gateway запущен:

bash
docker compose logs -f openclaw-gatewaycurl -fsS http://127.0.0.1:18789/healthz

Ответ /healthz с кодом 200 подтверждает, что процесс Gateway принимает подключения и исправен; встроенная проверка работоспособности образа HEALTHCHECK опрашивает ту же конечную точку.

Где и какие данные сохраняются

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

Компонент Расположение Механизм сохранения Примечания
Конфигурация Gateway /home/node/.openclaw/ Подключение тома хоста Включает openclaw.json
Учётные данные каналов и поставщиков /home/node/.openclaw/credentials/ Подключение тома хоста Данные учётных данных каналов и поставщиков
Профили аутентификации моделей /home/node/.openclaw/agents/ Подключение тома хоста agents/<agentId>/agent/auth-profiles.json (OAuth, ключи API)
Устаревший файл ключей OAuth /home/node/.config/openclaw/ Подключение тома хоста Совместимость только для чтения с дополнительными файлами OAuth до миграции; openclaw doctor --fix переносит их в auth-profiles.json
Конфигурации навыков /home/node/.openclaw/skills/ Подключение тома хоста Состояние на уровне навыка
Рабочее пространство агента /home/node/.openclaw/workspace/ Подключение тома хоста Код и артефакты агента
Сеанс WhatsApp /home/node/.openclaw/ Подключение тома хоста Сохраняет вход по QR-коду
Хранилище ключей Gmail /home/node/.openclaw/ Том хоста + пароль Требуется GOG_KEYRING_PASSWORD
Пакеты плагинов /home/node/.openclaw/npm, /home/node/.openclaw/git Подключение тома хоста Корневые каталоги загружаемых пакетов плагинов
Внешние исполняемые файлы /usr/local/bin/ Образ Docker Должны включаться на этапе сборки
Среда выполнения Node Файловая система контейнера Образ Docker Пересобирается при каждой сборке образа
Пакеты ОС Файловая система контейнера Образ Docker Не устанавливайте во время выполнения
Контейнер Docker Временный Перезапускаемый Можно безопасно удалить

Обновления

Чтобы обновить OpenClaw на виртуальной машине:

bash
git pulldocker compose builddocker compose up -d

Связанные материалы

Was this useful?