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

Виявлення ОС

Підтримує 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 — лише за наявності конфігурації.

Встановлення локального середовища виконання 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.

Перевірка середовища 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 і далі завершуються з ненульовим кодом для автоматизації.