Перейти до основного вмісту

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

  • Node 24 (рекомендовано) або Node 22.19+ - скрипт інсталятора обробляє це автоматично
  • macOS, Linux або Windows - користувачі Windows можуть почати з нативної програми Windows Hub, інсталятора CLI для PowerShell або WSL2 Gateway. Див. Windows.
  • pnpm потрібен лише якщо ви збираєте з вихідного коду

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

Найшвидший спосіб інсталяції. Він визначає вашу ОС, інсталює Node за потреби, інсталює OpenClaw і запускає первинне налаштування.
Користувачі робочого стола Windows також можуть інсталювати нативну супровідну програму Windows Hub, яка містить налаштування, статус у треї, чат, режим Node і локальний режим MCP.
curl -fsSL https://openclaw.ai/install.sh | bash
Щоб інсталювати без запуску первинного налаштування: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Усі прапорці та параметри 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@latest
openclaw onboard --install-daemon
Розміщений інсталятор очищує фільтри свіжості npm, такі як min-release-age, для інсталяції пакета OpenClaw. Якщо ви інсталюєте вручну через npm, ваша власна політика npm усе ще застосовується.

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

Для контриб’юторів або всіх, хто хоче запускати з локального 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 ... зсередини репозиторію. Повні робочі процеси розробки див. у Налаштуванні.

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

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

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

Docker

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

Podman

Безrootова контейнерна альтернатива 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, із резервним per-user елементом входу в Startup-folder, якщо створення завдання заборонено

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

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

VPS

Будь-який Linux VPS.

Docker VM

Спільні кроки Docker.

Kubernetes

Розгортання K8s.

Fly.io

Розгортання на Fly.io.

Hetzner

Розгортання Hetzner.

GCP

Розгортання Google Cloud.

Azure

Розгортання Azure.

Railway

Розгортання Railway.

Render

Розгортання Render.

Northflank

Розгортання 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.