OpenClawDocs
На цій сторінці

На цій сторінці

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

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

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

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

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

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

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 у межах того самого процесу з префіксом. Повна довідка: Внутрішня будова інсталятора.

Уже встановлено? Перемикайтеся між установленнями з пакета та 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

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

Для учасників розробки або всіх, хто хоче запускати OpenClaw із локальної робочої копії:

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

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

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

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

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

Docker

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

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

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

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

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

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

bash
openclaw --version      # переконайтеся, що CLI доступнийopenclaw doctor         # перевірте наявність проблем із конфігурацієюopenclaw gateway status # переконайтеся, що Gateway працює

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

  • 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.

bash
node -v           # Node установлено?npm prefix -g     # Де розташовані глобальні пакети?echo "$PATH"      # Чи є глобальний каталог виконуваних файлів у PATH?
Was this useful?