Внутрішня будова інсталятора

OpenClaw постачається з трьома сценаріями встановлення, доступними з openclaw.ai.

Сценарій	Платформа	Що він робить
`install.sh`	macOS / Linux / WSL	За потреби встановлює Node, встановлює OpenClaw через npm (типово) або git, може запустити початкове налаштування.
`install-cli.sh`	macOS / Linux / WSL	Встановлює Node і OpenClaw у локальний префікс (`~/.openclaw`) через npm або git. Права root не потрібні.
`install.ps1`	Windows (PowerShell)	За потреби встановлює Node, встановлює OpenClaw через npm (типово) або git, може запустити початкове налаштування.

Усі три підтримують Node 22.22.3+, 24.15+ або 25.9+; Node 24 є типовою цільовою версією для нових установлень.

Швидкі команди

install.sh
install-cli.sh
install.ps1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

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

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

Якщо встановлення завершилося успішно, але openclaw не знайдено в новому терміналі, див. усунення несправностей Node.js.

install.sh

Рекомендовано для більшості інтерактивних установлень у macOS/Linux/WSL.

Послідовність (install.sh)

Виявлення ОС

Підтримує macOS і Linux (зокрема WSL).

Типове забезпечення Node.js 24

Перевіряє версію Node і за потреби встановлює Node 24 (Homebrew у macOS, сценарії налаштування NodeSource у Linux із apt/dnf/yum). У macOS Homebrew встановлюється лише тоді, коли він потрібен інсталятору для Node або Git. Підтримуються Node 22.22.3+, Node 24.15+ і Node 25.9+; Node 23 не підтримується. В Alpine/musl Linux інсталятор використовує пакунки apk замість NodeSource і перевіряє фактичну версію пов’язаної бібліотеки SQLite. Поточні стабільні потоки пакунків Alpine можуть надавати достатньо нову версію Node із вразливою системною SQLite; у такому разі натомість використовуйте офіційний контейнер node:24-alpine або хост на основі glibc.

Забезпечення Git

Якщо Git відсутній, встановлює його за допомогою виявленого менеджера пакунків, зокрема Homebrew у macOS і apk в Alpine.

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

Метод npm (типово): глобальне встановлення через npm
Метод git: клонування/оновлення репозиторію, встановлення залежностей за допомогою pnpm, збирання, а потім встановлення обгортки в ~/.local/bin/openclaw

Завдання після встановлення

Визначає щойно встановлений виконуваний файл openclaw для подальших команд
Для неналаштованого встановлення запускає початкове налаштування перед перевірками doctor або Gateway. З --no-onboard або без TTY виводить команду для завершення налаштування пізніше.
Для налаштованого встановлення намагається оновити й перезапустити завантажену службу Gateway та запускає doctor. Під час оновлення за можливості оновлює плагіни або виводить команду для ручного виконання в безголовому запуску з увімкненими запитами.
Під час виконання --verify перевіряє встановлену версію, а стан Gateway — лише за наявності конфігурації.

Виявлення робочої копії вихідного коду

Якщо сценарій запущено всередині робочої копії OpenClaw (package.json + pnpm-workspace.yaml), він пропонує:

використати робочу копію (git) або
використати глобальне встановлення (npm)

Якщо TTY недоступний і метод встановлення не задано, типовим стає npm, а сценарій виводить попередження. Сценарій завершується з кодом 2, якщо вибрано недійсний метод або вказано недійсні значення --install-method.

Приклади (install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

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

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verify

Довідник прапорців

Прапорець	Опис
`--install-method \| --method npm\|git`	Вибрати метод встановлення (типово: `npm`)
`--npm`	Скорочення для методу npm
`--git \| --github`	Скорочення для методу git
`--version <version\|dist-tag\|spec>`	Версія npm, dist-tag або специфікація пакунка (типово: `latest`)
`--beta`	Використати dist-tag beta, якщо доступний, інакше повернутися до `latest`
`--git-dir \| --dir <path>`	Каталог робочої копії (типово: `~/openclaw`)
`--no-git-update`	Пропустити `git pull` для наявної робочої копії
`--no-prompt`	Вимкнути запити
`--no-onboard`	Пропустити початкове налаштування
`--onboard`	Увімкнути початкове налаштування
`--verify`	Виконати базову перевірку після встановлення (`--version`, стан Gateway, якщо завантажено)
`--dry-run`	Вивести дії без застосування змін
`--verbose`	Увімкнути налагоджувальне виведення (`set -x`, журнали npm рівня notice)
`--help \| -h`	Показати довідку

Довідник змінних середовища

Змінна	Опис
`OPENCLAW_INSTALL_METHOD=git\|npm`	Метод встановлення
`OPENCLAW_VERSION=latest\|next\|<semver>\|<spec>`	Версія npm, dist-tag або специфікація пакунка
`OPENCLAW_BETA=0\|1`	Використати beta, якщо доступна
`OPENCLAW_HOME=<path>`	Базовий каталог для стану OpenClaw і типових шляхів git/початкового налаштування
`OPENCLAW_GIT_DIR=<path>`	Каталог робочої копії
`OPENCLAW_GIT_UPDATE=0\|1`	Увімкнути або вимкнути оновлення git
`OPENCLAW_NO_PROMPT=1`	Вимкнути запити
`OPENCLAW_VERIFY_INSTALL=1`	Виконати базову перевірку після встановлення
`OPENCLAW_NO_ONBOARD=1`	Пропустити початкове налаштування
`OPENCLAW_DRY_RUN=1`	Режим пробного запуску
`OPENCLAW_VERBOSE=1`	Режим налагодження
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Рівень журналювання npm (типово: `error`, приховує повідомлення npm про застарілі функції)

install-cli.sh

Призначено для середовищ, у яких потрібно розмістити все під локальним префіксом (типово ~/.openclaw) без залежності від системного Node. Типово підтримує встановлення через npm, а також встановлення робочої копії git у межах тієї самої послідовності з префіксом.

Послідовність (install-cli.sh)

Встановлення локального середовища виконання Node

Завантажує закріплений підтримуваний tar-архів Node LTS (версію вбудовано в сценарій і оновлюється незалежно, типово 24.15.0) до <prefix>/tools/node-v<version> та перевіряє SHA-256. Linux ARMv7 використовує Node 22.22.3, оскільки офіційні двійкові файли Node 24+ для ARMv7 недоступні. В Alpine/musl Linux, для якого Node не публікує сумісні tar-архіви закріпленого середовища виконання, встановлює nodejs і npm за допомогою apk, а потім перевіряє Node і фактично пов’язану бібліотеку SQLite. Поточні стабільні потоки пакунків Alpine усе ще можуть компонуватися з вразливою SQLite навіть за достатньо нової версії Node; якщо перевірка безпеки відхиляє пакунок, використовуйте офіційний контейнер node:24-alpine або хост на основі glibc.

Забезпечення Git

Якщо Git відсутній, намагається встановити його через apt/dnf/yum/apk у Linux або Homebrew у macOS.

Встановлення OpenClaw під префіксом

Метод npm (типово): встановлює під префіксом за допомогою npm, а потім записує обгортку до <prefix>/bin/openclaw
Метод git: клонує/оновлює робочу копію (типово ~/openclaw) і так само записує обгортку до <prefix>/bin/openclaw

Оновлення завантаженої служби Gateway

Якщо службу Gateway уже завантажено з того самого префікса, сценарій виконує openclaw gateway install --force, що активує замінену службу, а потім намагається перевірити стан Gateway.

Приклади (install-cli.sh)

Типово
Власний префікс і версія
Встановлення через Git
Виведення JSON для автоматизації
Запустити початкове налаштування

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Довідник прапорців

Прапорець	Опис
`--prefix <path>`	Префікс встановлення (за замовчуванням: `~/.openclaw`)
`--install-method \| --method npm\|git`	Вибір способу встановлення (за замовчуванням: `npm`)
`--npm`	Скорочений варіант для способу npm
`--git \| --github`	Скорочений варіант для способу git
`--git-dir \| --dir <path>`	Каталог робочої копії Git (за замовчуванням: `~/openclaw`)
`--version <ver>`	Версія або dist-tag OpenClaw (за замовчуванням: `latest`)
`--node-version <ver>`	Версія Node (за замовчуванням: `24.15.0`; `22.22.3` у Linux ARMv7)
`--json`	Виводити події NDJSON
`--onboard`	Запустити `openclaw onboard` після встановлення
`--no-onboard`	Пропустити початкове налаштування (за замовчуванням)
`--set-npm-prefix`	У Linux примусово встановити префікс npm у `~/.npm-global`, якщо поточний префікс недоступний для запису
`--help \| -h`	Показати довідку з використання

Довідник змінних середовища

Змінна	Опис
`OPENCLAW_PREFIX=<path>`	Префікс встановлення
`OPENCLAW_INSTALL_METHOD=git\|npm`	Спосіб встановлення
`OPENCLAW_VERSION=<ver>`	Версія або dist-tag OpenClaw
`OPENCLAW_NODE_VERSION=<ver>`	Версія Node
`OPENCLAW_HOME=<path>`	Базовий каталог для стану OpenClaw і стандартних шляхів git/початкового налаштування
`OPENCLAW_GIT_DIR=<path>`	Каталог робочої копії Git для встановлень через git
`OPENCLAW_GIT_UPDATE=0\|1`	Увімкнення або вимкнення оновлень git для наявних робочих копій
`OPENCLAW_NO_ONBOARD=1`	Пропустити початкове налаштування
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Рівень журналювання npm (за замовчуванням: `error`)

openclaw@main та інші специфікації джерел GitHub не є припустимими цілями --version для встановлення через npm. Натомість використовуйте --install-method git --version main.

install.ps1

Послідовність (install.ps1)

Перевірка середовища PowerShell і Windows

Потрібен PowerShell 5+.

Забезпечення Node.js 24 за замовчуванням

Якщо його немає, виконується спроба встановлення через winget, потім Chocolatey, а потім Scoop. Якщо жоден менеджер пакетів недоступний, скрипт завантажує офіційний zip-архів Node.js 24 для Windows у %LOCALAPPDATA%\OpenClaw\deps\portable-node і додає його до PATH поточного процесу та користувача. Підтримуються Node 22.22.3+, Node 24.15+ і Node 25.9+; Node 23 не підтримується.

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

Спосіб npm (за замовчуванням): глобальне встановлення через npm із використанням вибраного -Tag, запущене з тимчасового каталогу інсталятора, доступного для запису, щоб оболонки, відкриті в захищених каталогах, як-от C:\, усе одно працювали
Спосіб git: клонувати або оновити репозиторій, установити й зібрати за допомогою pnpm та встановити обгортку в %USERPROFILE%\.local\bin\openclaw.cmd. Якщо Git відсутній, скрипт завантажує локальний для користувача MinGit у %LOCALAPPDATA%\OpenClaw\deps\portable-git і додає його до PATH поточного процесу та користувача.

Завдання після встановлення

За можливості додає потрібний каталог виконуваних файлів до PATH користувача
Намагається оновити завантажену службу Gateway (openclaw gateway install --force, потім перезапуск)
Запускає openclaw doctor --non-interactive під час оновлень і встановлень через git (за можливості)

Обробка помилок

Встановлення через iwr ... | iex і блок скрипту повідомляють про завершальну помилку, не закриваючи поточний сеанс PowerShell. Безпосередні встановлення через powershell -File / pwsh -File і далі завершуються з ненульовим кодом для автоматизації.

Приклади (install.ps1)

За замовчуванням
Встановлення через Git
Робоча копія гілки main з GitHub
Власний каталог git
Пробний запуск

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

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

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

Довідник прапорців

Прапорець	Опис
`-InstallMethod npm\|git`	Спосіб встановлення (за замовчуванням: `npm`)
`-Tag <tag\|version\|spec>`	dist-tag, версія або специфікація пакета npm (за замовчуванням: `latest`)
`-GitDir <path>`	Каталог робочої копії (за замовчуванням: `%USERPROFILE%\openclaw`)
`-NoOnboard`	Пропустити початкове налаштування
`-NoGitUpdate`	Пропустити `git pull`
`-DryRun`	Лише вивести дії

Довідник змінних середовища

Змінна	Опис
`OPENCLAW_INSTALL_METHOD=git\|npm`	Спосіб встановлення
`OPENCLAW_GIT_DIR=<path>`	Каталог робочої копії
`OPENCLAW_NO_ONBOARD=1`	Пропустити початкове налаштування
`OPENCLAW_GIT_UPDATE=0`	Вимкнути git pull
`OPENCLAW_DRY_RUN=1`	Режим пробного запуску

Якщо використовується -InstallMethod git, а Git відсутній, скрипт намагається спочатку завантажити локальний для користувача MinGit, а вже потім виводить посилання на Git for Windows.

CI та автоматизація

Для передбачуваних запусків використовуйте неінтерактивні прапорці та змінні середовища.

install.sh (неінтерактивний npm)
install.sh (неінтерактивний git)
install-cli.sh (JSON)
install.ps1 (пропустити початкове налаштування)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

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

Усунення несправностей

Чому потрібен Git?

Git потрібен для способу встановлення git. Для встановлень npm Git також перевіряється та встановлюється, щоб уникнути помилок spawn git ENOENT, коли залежності використовують URL-адреси git.

Чому npm повертає EACCES у Linux?

У деяких конфігураціях Linux глобальний префікс npm указує на шляхи, що належать користувачу root. install.sh може змінити префікс на ~/.npm-global і додати експортування PATH до rc-файлів оболонки (якщо ці файли існують).

Windows: "npm error spawn git / ENOENT"

Повторно запустіть інсталятор, щоб він міг завантажити локальний для користувача MinGit, або встановіть Git for Windows і знову відкрийте PowerShell.

Windows: "openclaw is not recognized"

Запустіть npm config get prefix і додайте цей каталог до PATH користувача (суфікс \bin у Windows не потрібен), а потім знову відкрийте PowerShell.

Windows: як отримати докладний вивід інсталятора

install.ps1 не надає перемикача -Verbose. Для діагностики на рівні скрипту використовуйте трасування PowerShell:

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

openclaw не знайдено після встановлення

Зазвичай це проблема з PATH. Див. усунення несправностей Node.js.

Install overview

Maintenance

Containers

Hosting

Advanced setup

Внутрішня будова інсталятора

Швидкі команди

install.sh

Послідовність (install.sh)

Виявлення робочої копії вихідного коду

Приклади (install.sh)

install-cli.sh

Послідовність (install-cli.sh)

Приклади (install-cli.sh)

install.ps1

Послідовність (install.ps1)

Приклади (install.ps1)

CI та автоматизація

Усунення несправностей

Пов’язані матеріали

​Швидкі команди

​install.sh

​Послідовність (install.sh)

​Виявлення робочої копії вихідного коду

​Приклади (install.sh)

​install-cli.sh

​Послідовність (install-cli.sh)

​Приклади (install-cli.sh)

​install.ps1

​Послідовність (install.ps1)

​Приклади (install.ps1)

​CI та автоматизація

​Усунення несправностей

​Пов’язані матеріали

Швидкі команди

install.sh

Послідовність (install.sh)

Виявлення робочої копії вихідного коду

Приклади (install.sh)

install-cli.sh

Послідовність (install-cli.sh)

Приклади (install-cli.sh)

install.ps1

Послідовність (install.ps1)

Приклади (install.ps1)

CI та автоматизація

Усунення несправностей

Пов’язані матеріали