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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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

Найшвидший спосіб інсталяції. Він визначає вашу ОС, інсталює Node за потреби, інсталює OpenClaw і запускає onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Щоб інсталювати без запуску onboarding: 
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
Якщо 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

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

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

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

Розгорніть 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

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

Оновлення

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

Міграція

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

Деінсталяція

Повністю видаліть 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, додайте його до startup-файлу вашої shell (~/.zshrc або ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Потім відкрийте новий термінал. Докладніше див. у Налаштуванні Node.