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

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

• Node 24 (рекомендовано) або Node 22.19+ - скрипт інсталятора обробляє це автоматично
• macOS, Linux або Windows - користувачі Windows можуть почати з нативної програми Windows Hub, інсталятора CLI для PowerShell або WSL2 Gateway. Див. 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-checkout у тому самому потоці з префіксом. Повна довідка: Внутрішня робота інсталятора.

Уже інстальовано? Перемикайтеся між інсталяціями з пакета та 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

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

Для контриб’юторів або всіх, хто хоче запускати з локального checkout:

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

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

Інсталяція з checkout GitHub main

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

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

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

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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

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

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

Розгорніть OpenClaw на хмарному сервері або VPS:

Оновлення, міграція або видалення

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

Якщо інсталяція успішна, але openclaw не знайдено у вашому терміналі:

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

Якщо $(npm prefix -g)/bin немає у вашому $PATH, додайте його до стартового файла оболонки (~/.zshrc або ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Потім відкрийте новий термінал. Докладніше див. у Налаштуванні Node.