Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

Встановлення бінарних файлів усередині запущеного контейнера — пастка. Усе, що встановлено під час виконання, буде втрачено після перезапуску. Усі зовнішні бінарні файли, потрібні для 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"]
Наведені вище URL є прикладами. Для віртуальних машин на ARM вибирайте ресурси arm64. Для відтворюваних збірок закріплюйте URL версійних релізів.

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

docker compose build
docker compose up -d openclaw-gateway
Якщо збирання завершується помилкою Killed або exit code 137 під час pnpm install --frozen-lockfile, на віртуальній машині бракує пам’яті. Перед повторною спробою використайте більший клас машини. Перевірте бінарні файли: 
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)
Ключ профілю автентифікації/home/node/.config/openclaw/Монтування тому хостаЛокальний ключ шифрування для матеріалу токенів профілю автентифікації OAuth
Конфігурації Skills/home/node/.openclaw/skills/Монтування тому хостаСтан на рівні Skill
Робочий простір агента/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Мають бути вбудовані під час збирання
Середовище виконання NodeФайлова система контейнераОбраз DockerПерезбирається під час кожного збирання образу
Пакети ОСФайлова система контейнераОбраз DockerНе встановлюйте під час виконання
Контейнер DockerТимчасовийМожна перезапуститиБезпечно знищувати

​
Оновлення

Щоб оновити OpenClaw на віртуальній машині: 
git pull
docker compose build
docker compose up -d

​
Пов’язане