Установити

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

• Node 22.19+, 23.11+ або 24+ — 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

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

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

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      # підтвердити доступність CLIopenclaw 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?