Skip to main content

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

  • Node 22.22.3+, 24.15+ або 25.9+ — Node 24 є цільовою версією за замовчуванням; скрипт інсталятора обробляє це автоматично.
  • macOS, Linux або Windows — користувачі Windows можуть почати з нативного застосунку Windows Hub, інсталятора CLI для PowerShell або Gateway у WSL2. Див. Windows.
  • pnpm потрібен лише для збирання з вихідного коду.

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

Найшвидший спосіб установлення. Він визначає вашу ОС, за потреби встановлює Node, установлює OpenClaw і запускає початкове налаштування.
Користувачі настільної версії Windows також можуть установити нативний допоміжний застосунок Windows Hub, який містить засоби налаштування, відображення стану в системному треї, чат, режим Node і локальний режим MCP.
Щоб установити без запуску початкового налаштування:
Усі прапорці та параметри для CI й автоматизації описано в розділі Внутрішня будова інсталятора.

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

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

Використовуйте цей спосіб, якщо потрібно зберігати OpenClaw і Node у каталозі з локальним префіксом, наприклад ~/.openclaw, без залежності від загальносистемного встановлення Node:
За замовчуванням він підтримує встановлення через npm, а також установлення з робочої копії git у межах того самого процесу з префіксом. Повна довідка: Внутрішня будова інсталятора. Уже встановлено? Перемикайтеся між установленнями з пакета та git за допомогою openclaw update --channel dev і openclaw update --channel stable. Див. Оновлення.

​
npm, pnpm або bun

Якщо ви вже самостійно керуєте Node:
Розміщений інсталятор скидає фільтри актуальності npm, як-от min-release-age, під час установлення пакета OpenClaw. Якщо ви встановлюєте його вручну через npm, ваша власна політика npm усе одно застосовується.

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

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

​
Установлення з основної робочої копії GitHub

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

Docker

Контейнеризовані розгортання або розгортання без графічного інтерфейсу.

Podman

Безпривілейована контейнерна альтернатива Docker.

Nix

Декларативне встановлення за допомогою Nix flake.

Ansible

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

Bun

Необов’язковий інсталятор залежностей і засіб запуску скриптів пакетів.

​
Перевірка встановлення

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

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

Розгорніть OpenClaw на хмарному сервері або VPS. Повний перелік провайдерів (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi тощо) див. у розділі Сервер Linux; також можна виконати декларативне розгортання на Render.

VPS

Виберіть провайдера.

Віртуальна машина Docker

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

Kubernetes

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

​
Оновлення, перенесення або видалення

Оновлення

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

Перенесення

Перенесіть на новий комп’ютер.

Видалення

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

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

Майже завжди це проблема з PATH: глобальний каталог виконуваних файлів npm відсутній у змінній PATH вашої оболонки. Повний спосіб виправлення, зокрема шлях для Windows, див. у розділі Усунення несправностей Node.js.