English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

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

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

  • Node 24 (рекомендовано) або Node 22.14+ - скрипт інсталятора обробляє це автоматично
  • macOS, Linux або Windows - підтримуються як нативний Windows, так і WSL2; WSL2 стабільніший. Див. Windows.
  • pnpm потрібен лише якщо ви збираєте з вихідного коду

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

& ([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

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

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun

bun add -g openclaw@latest
openclaw onboard --install-daemon
Troubleshooting: sharp build errors (npm)

Якщо sharp завершується помилкою через глобально інстальований libvips:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

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

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

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

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

npm install -g github:openclaw/openclaw#main

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

Docker

Контейнеризовані або headless-розгортання.
Podman

Rootless контейнерна альтернатива Docker.
Nix

Декларативна інсталяція через Nix flake.
Ansible

Автоматизоване підготування парку машин.
Bun

Використання лише CLI через середовище виконання Bun.

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

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

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

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

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

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

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii91ay9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

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

Updating

Підтримуйте OpenClaw в актуальному стані.
Migrating

Перенесіть на нову машину.
Uninstall

Повністю видаліть OpenClaw.

Усунення несправностей: 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.