Цей сайт найкраще переглядати в сучасному браузері з включеним JavaScript.

Як встановити OpenClaw (MoltBot, ClawdBot) у Docker на Windows: повний гайд

admin

🚀 Повний гайд: Розгортання OpenClaw у Docker на Windows

[cite_start]Ця інструкція допоможе обійти специфічні проблеми Windows під час встановлення OpenClaw: помилки прав доступу (EACCES), падіння шлюзу через CORS та складнощі зі сполученням пристроїв (Pairing).

📋 Попередні вимоги

[cite_start]Docker Desktop: встановлений та запущений з увімкненим Docker Compose v2.
PowerShell: термінал, запущений від імені Адміністратора (це критично для уникнення помилок із правами запису файлів).
Git: для завантаження проекту.

📥 Крок 1. Завантаження та підготовка проекту

Перш ніж приступати до налаштування, необхідно завантажити код та підготувати робочу директорію.

Відкрийте PowerShell від імені Адміністратора.

Виконайте наступні команди:

# Клонуємо репозиторій
git clone https://github.com/openclaw/openclaw.git

# Переходимо в папку проекту
cd openclaw

У Windows змінні оточення часто не підхоплюються автоматично, тому ми створимо їх вручну в кореневій папці проекту.

У папці openclaw створіть файл з назвою .env.

Вставте в нього такий вміст:
OPENCLAW_CONFIG_DIR=./config
OPENCLAW_WORKSPACE_DIR=./workspace

# Токен додамо на Кроці 5
OPENCLAW_GATEWAY_TOKEN=

# Заглушки для пригнічення системних попереджень
CLAUDE_AI_SESSION_KEY=
CLAUDE_WEB_SESSION_KEY=
CLAUDE_WEB_COOKIE=

🛠 Крок 3. Початкове налаштування (Onboarding)

Запускаємо майстер налаштування для генерації конфігураційних файлів.
перейти в папку проекту cd openclaw

docker build -t openclaw:local -f Dockerfile .
docker compose run --rm openclaw-cli onboard

Важливо: Якщо виникне помилка EACCES: permission denied, переконайтеся, що у властивостях папки проекту знято прапорець "Тільки для читання" і ви запустили PowerShell від імені Адміністратора.

🌐 Крок 4. Виправлення падіння шлюзу (Фікс CORS)

За замовчуванням шлюз у Docker на Windows може падати з помилкою безпеки. Потрібно дозволити доступ вашому браузеру.

Відкрийте файл config/openclaw.json.

Знайдіть секцію "gateway" і приведіть її до такого вигляду:

"gateway": {
  "port": 18789,
  "mode": "local",
  "bind": "lan",
  "controlUi": {
    "allowedOrigins": [
      "http://127.0.0.1:18789",
      "http://localhost:18789"
    ]
  },
  "auth": {
    "mode": "token",
    "token": "ВАШ_ЗГЕНЕРОВАНИЙ_ТОКЕН"
  }
}

Налаштування "bind": "lan" дозволяє контейнеру Docker приймати запити з вашої основної системи Windows.

🔑 Крок 5. Синхронізація токена

Скопіюйте значення "token" з файлу config/openclaw.json (який ви редагували на попередньому кроці) і вставте його у файл .env у рядок:
OPENCLAW_GATEWAY_TOKEN=ваш_токен_тут

🚢 Крок 6. Запуск сервісу

Тепер запускаємо шлюз у фоновому режимі:

# Зупиняємо старі процеси, якщо вони є
docker compose down

# Запускаємо шлюз
docker compose up -d openclaw-gateway

Після цього панель керування стане доступною за адресою: http://127.0.0.1:18789/._

🔐 Крок 7. Схвалення пристрою (Pairing Required)

Під час першого входу ви побачите червоний екран pairing required. Це механізм захисту OpenClaw.

Не закривайте вкладку у браузері.

У терміналі виконайте команду, щоб знайти ID вашого запиту:

docker compose exec openclaw-gateway node dist/index.js devices list
Скопіюйте ID з колонки Request (наприклад, 1d55720c-...).

Схваліть його командою:

docker compose exec openclaw-gateway node dist/index.js devices approve ВАШ_REQUEST_ID
Вітаю! Сторінка в браузері автоматично оновиться, і ви отримаєте повний доступ до адмін-панелі OpenClaw.