Установлення

Системні вимоги

• Node 22.22.3+, 24.15+ або 25.9+ — Node 24 є цільовою версією за замовчуванням; скрипт інсталятора обробляє це автоматично.
• macOS, Linux або Windows — користувачі Windows можуть почати з нативного застосунку Windows Hub, інсталятора CLI для PowerShell або Gateway у WSL2. Див. Windows.
• pnpm потрібен лише для збирання з вихідного коду.

Рекомендовано: скрипт інсталятора

Найшвидший спосіб установлення. Він визначає вашу ОС, за потреби встановлює Node, установлює OpenClaw і запускає початкове налаштування.

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

Щоб установити без запуску початкового налаштування:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Усі прапорці та параметри для CI й автоматизації описано в розділі Внутрішня будова інсталятора.

Альтернативні способи встановлення

Інсталятор із локальним префіксом (install-cli.sh)

Використовуйте цей спосіб, якщо потрібно зберігати OpenClaw і Node у каталозі з локальним префіксом, наприклад ~/.openclaw, без залежності від загальносистемного встановлення Node:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

За замовчуванням він підтримує встановлення через npm, а також установлення з робочої копії git у межах того самого процесу з префіксом. Повна довідка: Внутрішня будова інсталятора.

Уже встановлено? Перемикайтеся між установленнями з пакета та git за допомогою openclaw update --channel dev і openclaw update --channel stable. Див. Оновлення.

npm, pnpm або bun

Якщо ви вже самостійно керуєте Node:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

З вихідного коду

Для учасників розробки або всіх, хто хоче запускати OpenClaw із локальної робочої копії:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Або пропустіть створення посилання та використовуйте pnpm openclaw ... у репозиторії. Повний опис процесів розробки див. у розділі Налаштування.

Установлення з основної робочої копії GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Контейнери та менеджери пакетів

Перевірка встановлення

openclaw --version      # переконайтеся, що CLI доступнийopenclaw doctor         # перевірте наявність проблем із конфігурацієюopenclaw gateway status # переконайтеся, що Gateway працює

Якщо після встановлення потрібен керований запуск:

• macOS: LaunchAgent через openclaw onboard --install-daemon або openclaw gateway install
• Linux/WSL2: користувацька служба systemd через ті самі команди
• Нативна Windows: спочатку Scheduled Task, а якщо створення завдання заборонено — резервний елемент входу в систему в папці Startup для окремого користувача

Хостинг і розгортання

Розгорніть OpenClaw на хмарному сервері або VPS. Повний перелік провайдерів (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi тощо) див. у розділі Сервер Linux; також можна виконати декларативне розгортання на Render.

Оновлення, перенесення або видалення

Усунення несправностей: openclaw не знайдено

Майже завжди це проблема з PATH: глобальний каталог виконуваних файлів npm відсутній у змінній PATH вашої оболонки. Повний спосіб виправлення, зокрема шлях для Windows, див. у розділі Усунення несправностей Node.js.

node -v           # Node установлено?npm prefix -g     # Де розташовані глобальні пакети?echo "$PATH"      # Чи є глобальний каталог виконуваних файлів у PATH?