Внутреннее устройство установщика¶
OpenClaw поставляется с тремя скриптами установщика, доступными по адресу openclaw.ai.
| Скрипт | Платформа | Что делает |
|---|---|---|
install.sh |
macOS / Linux / WSL | Устанавливает Node при необходимости, устанавливает OpenClaw через npm (по умолчанию) или git и может запустить онбординг. |
install-cli.sh |
macOS / Linux / WSL | Устанавливает Node + OpenClaw в локальный префикс (~/.openclaw). Права root не требуются. |
install.ps1 |
Windows (PowerShell) | Устанавливает Node при необходимости, устанавливает OpenClaw через npm (по умолчанию) или git и может запустить онбординг. |
Быстрые команды¶
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
```
````
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
```
````
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
````
```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun
```
````
openclaw не найден в новом терминале, см. устранение неполадок Node.js.
install.sh¶
Поток выполнения (install.sh)¶
npm (по умолчанию): глобальная установка через npm
- метод git: клонирование/обновление репозитория, установка зависимостей через pnpm, сборка и установка обёртки в ~/.local/bin/openclaw
openclaw doctor --non-interactive при обновлениях и установках из git (best effort)
- Пытается выполнить онбординг при подходящих условиях (доступен TTY, онбординг не отключён, проверки bootstrap/конфига пройдены)
- По умолчанию SHARP_IGNORE_GLOBAL_LIBVIPS=1
Обнаружение checkout исходников¶
Если скрипт запущен внутри checkout OpenClaw (package.json + pnpm-workspace.yaml), он предлагает:
- использовать checkout (
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
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run
| Флаг | Описание |
|---|---|
--install-method npm\\|git |
Выбор метода установки (по умолчанию: npm). Псевдоним: --method |
--npm |
Быстрый выбор метода npm |
--git |
Быстрый выбор метода git. Псевдоним: --github |
--version <version\\|dist-tag> |
Версия npm или dist-tag (по умолчанию: latest) |
--beta |
Использовать beta dist-tag при наличии, иначе fallback на latest |
--git-dir <path> |
Каталог checkout (по умолчанию: ~/openclaw). Псевдоним: --dir |
--no-git-update |
Пропустить git pull для существующего checkout |
--no-prompt |
Отключить запросы |
--no-onboard |
Пропустить онбординг |
--onboard |
Включить онбординг |
--dry-run |
Печать действий без применения изменений |
--verbose |
Включить отладочный вывод (set -x, логи npm уровня notice) |
--help |
Показать справку (-h) |
| Переменная | Описание |
|---|---|
OPENCLAW_INSTALL_METHOD=git\\|npm |
Метод установки |
OPENCLAW_VERSION=latest\\|next\\|<semver> |
Версия npm или dist-tag |
OPENCLAW_BETA=0\\|1 |
Использовать beta при наличии |
OPENCLAW_GIT_DIR=<path> |
Каталог checkout |
OPENCLAW_GIT_UPDATE=0\\|1 |
Переключение обновлений git |
OPENCLAW_NO_PROMPT=1 |
Отключить запросы |
OPENCLAW_NO_ONBOARD=1 |
Пропустить онбординг |
OPENCLAW_DRY_RUN=1 |
Режим пробного запуска |
OPENCLAW_VERBOSE=1 |
Режим отладки |
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice |
Уровень логирования npm |
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1 |
Управление поведением sharp/libvips (по умолчанию: 1) |
install-cli.sh¶
~/.openclaw) и без зависимости от системного Node.
Поток выполнения (install-cli.sh)¶
22.22.0) в <prefix>/tools/node-v<version> и проверяет SHA-256.
--prefix <prefix>, затем записывает обёртку в <prefix>/bin/openclaw.
Примеры (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
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) |
--version <ver> |
Версия OpenClaw или dist-tag (по умолчанию: latest) |
--node-version <ver> |
Версия Node (по умолчанию: 22.22.0) |
--json |
Вывод событий NDJSON |
--onboard |
Запустить openclaw onboard после установки |
--no-onboard |
Пропустить онбординг (по умолчанию) |
--set-npm-prefix |
В Linux принудительно установить npm prefix в ~/.npm-global, если текущий prefix недоступен для записи |
--help |
Показать справку (-h) |
| Переменная | Описание |
|---|---|
OPENCLAW_PREFIX=<path> |
Префикс установки |
OPENCLAW_VERSION=<ver> |
Версия OpenClaw или dist-tag |
OPENCLAW_NODE_VERSION=<ver> |
Версия Node |
OPENCLAW_NO_ONBOARD=1 |
Пропустить онбординг |
OPENCLAW_NPM_LOGLEVEL=error\\|warn\\|notice |
Уровень логирования npm |
OPENCLAW_GIT_DIR=<path> |
Путь поиска для устаревшей очистки (используется при удалении старого checkout подмодуля Peekaboo) |
SHARP_IGNORE_GLOBAL_LIBVIPS=0\\|1 |
Управление поведением sharp/libvips (по умолчанию: 1) |
install.ps1¶
Поток выполнения (install.ps1)¶
npm (по умолчанию): глобальная установка через npm с использованием выбранного -Tag
- метод git: клонирование/обновление репозитория, установка/сборка через pnpm и установка обёртки в %USERPROFILE%\.local\bin\openclaw.cmd
openclaw doctor --non-interactive при обновлениях и установках из git (best effort).
Примеры (install.ps1)¶
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod 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> |
npm dist-tag (по умолчанию: latest) |
-GitDir <path> |
Каталог checkout (по умолчанию: %USERPROFILE%\openclaw) |
-NoOnboard |
Пропустить онбординг |
-NoGitUpdate |
Пропустить git pull |
-DryRun |
Печать только действий |
| Переменная | Описание |
|---|---|
OPENCLAW_INSTALL_METHOD=git\\|npm |
Метод установки |
OPENCLAW_GIT_DIR=<path> |
Каталог checkout |
OPENCLAW_NO_ONBOARD=1 |
Пропустить онбординг |
OPENCLAW_GIT_UPDATE=0 |
Отключить git pull |
OPENCLAW_DRY_RUN=1 |
Режим пробного запуска |
-InstallMethod git и Git отсутствует, скрипт завершает работу и выводит ссылку на Git for Windows.
CI и автоматизация¶
Используйте неинтерактивные флаги/переменные окружения для предсказуемых запусков.
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard
bash
OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw
powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Устранение неполадок¶
git. Для установок npm Git всё равно проверяется/устанавливается, чтобы избежать сбоев spawn git ENOENT, когда зависимости используют git URL.
install.sh может переключить prefix на ~/.npm-global и добавить экспорты PATH в файлы rc оболочки (когда такие файлы существуют).
SHARP_IGNORE_GLOBAL_LIBVIPS=1, чтобы избежать сборки sharp против системного libvips. Чтобы переопределить:
````
```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```
````
npm config get prefix, добавьте \bin, добавьте этот каталог в пользовательский PATH, затем перезапустите PowerShell.