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

Install overview

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

Edit source

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

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

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Щоб інсталювати без запуску onboarding:

macOS / Linux / WSL2

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

Windows (PowerShell)

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

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

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

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

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

bash
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

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

pnpm

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

bun

bash
bun add -g openclaw@latestopenclaw onboard --install-daemon
Усунення несправностей: помилки збірки sharp (npm)

Якщо sharp дає збій через глобально інстальований libvips:

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

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

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

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

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

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

bash
npm install -g github:openclaw/openclaw#main

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

Docker

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

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

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

Автоматизоване підготовлення fleet.
Bun

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

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

bash
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, із резервним login item у теці Startup для конкретного користувача, якщо створення завдання відхилено

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

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

VPS
Docker VM
Kubernetes

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

Hetzner
GCP
Azure
Railway
Render
Northflank

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

Оновлення

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

Перенесіть на нову машину.
Деінсталяція

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

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

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

bash
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, додайте його до startup-файлу вашої shell (~/.zshrc або ~/.bashrc):

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

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

Was this useful?