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

Install overview

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

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.19+, 23.11+ або 24+; Node 24 є типовою цільовою версією для нових установлень.

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

install.sh

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

install-cli.sh

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

install.ps1

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

install.sh

Процес (install.sh)

  • Виявлення ОС

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

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

    Перевіряє версію Node і за потреби встановлює Node 24 (через Homebrew у macOS, сценарії налаштування NodeSource у Linux із apt/dnf/yum). У macOS Homebrew встановлюється лише тоді, коли він потрібен інсталятору для Node або Git. Node 22.19+ і 23.11+ залишаються підтримуваними для сумісності. В Alpine/musl Linux інсталятор використовує пакунки apk замість NodeSource; налаштовані репозиторії Alpine мають надавати підтримувану версію Node (на момент написання — Alpine 3.21 або новішу).

  • Забезпечення 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)

    Типово

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

    Пропустити початкове налаштування

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

    Встановлення через Git

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

    Робоча копія основної гілки GitHub

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

    Пробний запуск

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

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

    bash
    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

    Процес (install-cli.sh)

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

    Завантажує архів tar із зафіксованою підтримуваною версією Node LTS (версію вбудовано в сценарій і оновлюють незалежно; типово 22.22.2) до <prefix>/tools/node-v<version> та перевіряє SHA-256. В Alpine/musl Linux, для якої Node не публікує сумісні архіви tar із зафіксованим середовищем виконання, встановлює nodejs і npm через apk та прив’язує це середовище виконання до шляху обгортки в префіксі. Репозиторії Alpine мають надавати підтримувану версію Node (22.19+, 23.11+ або 24+); використовуйте Alpine 3.21 або новішу, якщо старіші репозиторії надають лише Node 20 або 21.

  • Забезпечення 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, потім openclaw gateway restart і за можливості перевіряє стан Gateway.

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

    Типово

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

    Власний префікс і версія

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

    Встановлення через Git

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

    Виведення JSON для автоматизації

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

    Запуск початкового налаштування

    bash
    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> Версія OpenClaw або dist-тег (типово: latest)
    --node-version <ver> Версія Node (типово: 22.22.2)
    --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> Версія OpenClaw або dist-тег
    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)

    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.19+ і 23.11+.

  • Встановлення 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)

    Типове встановлення

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

    Встановлення через Git

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

    Робоча копія основної гілки GitHub

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

    Власний каталог git

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

    Пробний запуск

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun
    Довідник параметрів
    Параметр Опис
    -InstallMethod npm|git Метод встановлення (типово: npm)
    -Tag <tag|version|spec> dist-тег 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 Режим пробного запуску

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

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

    install.sh (неінтерактивний npm)

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

    install.sh (неінтерактивний git)

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

    install-cli.sh (JSON)

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

    install.ps1 (без початкового налаштування)

    powershell
    & ([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 користувача (у Windows суфікс \bin не потрібен), а потім повторно відкрийте PowerShell.

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

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

    powershell
    Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0
    openclaw не знайдено після встановлення

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

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

    Was this useful?
    On this page

    On this page