OpenClaw постачає три інсталяційні скрипти, які обслуговуються зDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw.ai.
| Скрипт | Платформа | Що він робить |
|---|---|---|
install.sh | macOS / Linux / WSL | За потреби встановлює Node, встановлює OpenClaw через npm (типово) або git і може запустити onboarding. |
install-cli.sh | macOS / Linux / WSL | Встановлює Node + OpenClaw у локальний префікс (~/.openclaw) у режимах npm або git checkout. Root не потрібен. |
install.ps1 | Windows (PowerShell) | За потреби встановлює Node, встановлює OpenClaw через npm (типово) або git і може запустити onboarding. |
Швидкі команди
- install.sh
- install-cli.sh
- install.ps1
Якщо встановлення успішне, але
openclaw не знайдено в новому терміналі, див. усунення несправностей Node.js.install.sh
Процес (install.sh)
Визначення ОС
Підтримує macOS і Linux (зокрема WSL). Якщо виявлено macOS, встановлює Homebrew, якщо його немає.
Типово забезпечення Node.js 24
Перевіряє версію Node і за потреби встановлює Node 24 (Homebrew на macOS, скрипти налаштування NodeSource на Linux apt/dnf/yum). OpenClaw все ще підтримує Node 22 LTS, наразі
22.16+, для сумісності.Встановлення OpenClaw
- метод
npm(типово): глобальне встановлення npm - метод
git: клонує/оновлює репозиторій, встановлює залежності через pnpm, збирає, а потім встановлює обгортку в~/.local/bin/openclaw
Завдання після встановлення
- Оновлює завантажений сервіс gateway за найкращою спробою (
openclaw gateway install --force, потім перезапуск) - Запускає
openclaw doctor --non-interactiveпід час оновлень і git-встановлень (за найкращою спробою) - Намагається виконати onboarding, коли це доречно (TTY доступний, onboarding не вимкнено, а перевірки bootstrap/config проходять)
- Типово встановлює
SHARP_IGNORE_GLOBAL_LIBVIPS=1
Виявлення checkout вихідного коду
Якщо запущено всередині checkout OpenClaw (package.json + pnpm-workspace.yaml), скрипт пропонує:
- використати checkout (
git), або - використати глобальне встановлення (
npm)
npm і виводиться попередження.
Скрипт завершується з кодом 2 у разі недійсного вибору методу або недійсних значень --install-method.
Приклади (install.sh)
- Типово
- Пропустити onboarding
- Git-встановлення
- GitHub main через npm
- Пробний запуск
Довідник прапорців
Довідник прапорців
| Прапорець | Опис |
|---|---|
--install-method npm|git | Вибрати метод встановлення (типово: npm). Псевдонім: --method |
--npm | Скорочення для методу npm |
--git | Скорочення для методу git. Псевдонім: --github |
--version <version|dist-tag|spec> | Версія 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 | Пропустити onboarding |
--onboard | Увімкнути onboarding |
--dry-run | Вивести дії без застосування змін |
--verbose | Увімкнути debug-вивід (set -x, журнали npm рівня notice) |
--help | Показати використання (-h) |
Довідник змінних середовища
Довідник змінних середовища
| Змінна | Опис |
|---|---|
OPENCLAW_INSTALL_METHOD=git|npm | Метод встановлення |
OPENCLAW_VERSION=latest|next|main|<semver>|<spec> | Версія 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 | Пропустити onboarding |
OPENCLAW_DRY_RUN=1 | Режим пробного запуску |
OPENCLAW_VERBOSE=1 | Debug-режим |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice | Рівень журналювання npm |
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | Керування поведінкою sharp/libvips (типово: 1) |
install-cli.sh
Призначено для середовищ, де потрібно розмістити все під локальним префіксом
(типово
~/.openclaw) і не мати системної залежності Node. Типово підтримує npm-встановлення,
а також git-checkout встановлення в тому самому процесі з префіксом.Процес (install-cli.sh)
Встановлення локального runtime Node
Завантажує закріплений підтримуваний tarball Node LTS (версія вбудована в скрипт і оновлюється незалежно) до
<prefix>/tools/node-v<version> і перевіряє SHA-256.Забезпечення Git
Якщо Git відсутній, намагається встановити через apt/dnf/yum на Linux або Homebrew на macOS.
Встановлення OpenClaw під префіксом
- метод
npm(типово): встановлює під префіксом через npm, потім записує обгортку в<prefix>/bin/openclaw - метод
git: клонує/оновлює checkout (типово~/openclaw) і все одно записує обгортку в<prefix>/bin/openclaw
Приклади (install-cli.sh)
- Типово
- Власний префікс + версія
- Git-встановлення
- JSON-вивід для автоматизації
- Запустити onboarding
Довідник прапорців
Довідник прапорців
| Прапорець | Опис |
|---|---|
--prefix <path> | Префікс встановлення (типово: ~/.openclaw) |
--install-method npm|git | Вибрати метод встановлення (типово: npm). Псевдонім: --method |
--npm | Скорочення для методу npm |
--git, --github | Скорочення для методу git |
--git-dir <path> | Каталог git checkout (типово: ~/openclaw). Псевдонім: --dir |
--version <ver> | Версія OpenClaw або dist-tag (типово: latest) |
--node-version <ver> | Версія Node (типово: 22.22.0) |
--json | Виводити події NDJSON |
--onboard | Запустити openclaw onboard після встановлення |
--no-onboard | Пропустити onboarding (типово) |
--set-npm-prefix | На Linux примусово задати префікс npm як ~/.npm-global, якщо поточний префікс недоступний для запису |
--help | Показати використання (-h) |
Довідник змінних середовища
Довідник змінних середовища
| Змінна | Опис |
|---|---|
OPENCLAW_PREFIX=<path> | Префікс встановлення |
OPENCLAW_INSTALL_METHOD=git|npm | Метод встановлення |
OPENCLAW_VERSION=<ver> | Версія OpenClaw або dist-tag |
OPENCLAW_NODE_VERSION=<ver> | Версія Node |
OPENCLAW_GIT_DIR=<path> | Каталог робочої копії Git для git-встановлень |
OPENCLAW_GIT_UPDATE=0|1 | Перемкнути git-оновлення для наявних робочих копій |
OPENCLAW_NO_ONBOARD=1 | Пропустити початкове налаштування |
OPENCLAW_NPM_LOGLEVEL=error|warn|notice | Рівень журналювання npm |
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | Керувати поведінкою sharp/libvips (типово: 1) |
install.ps1
Потік (install.ps1)
Типово забезпечити Node.js 24
Якщо відсутній, намагається встановити через winget, потім Chocolatey, потім Scoop. Node 22 LTS, наразі
22.16+, залишається підтримуваним для сумісності.Встановити OpenClaw
- Метод
npm(типово): глобальне встановлення npm із вибраним-Tag, запущене з доступного для запису тимчасового каталогу інсталятора, тож оболонки, відкриті в захищених папках, як-отC:\, усе одно працюють - Метод
git: клонувати/оновити репозиторій, встановити/зібрати за допомогою pnpm і встановити обгортку в%USERPROFILE%\.local\bin\openclaw.cmd
Завдання після встановлення
- Додає потрібний bin-каталог до користувацького PATH, коли це можливо
- За можливості оновлює завантажений сервіс Gateway (
openclaw gateway install --force, потім перезапуск) - Запускає
openclaw doctor --non-interactiveпід час оновлень і git-встановлень (за можливості)
Приклади (install.ps1)
- Типово
- Git-встановлення
- GitHub main через npm
- Власний git-каталог
- Пробний запуск
- Трасування для налагодження
Довідник прапорців
Довідник прапорців
| Прапорець | Опис |
|---|---|
-InstallMethod npm|git | Метод встановлення (типово: npm) |
-Tag <tag|version|spec> | npm dist-tag, версія або специфікація пакета (типово: 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 відсутній, скрипт завершується та виводить посилання Git for Windows.CI та автоматизація
Використовуйте неінтерактивні прапорці/змінні середовища для передбачуваних запусків.- install.sh (неінтерактивний npm)
- install.sh (неінтерактивний git)
- install-cli.sh (JSON)
- install.ps1 (пропустити початкове налаштування)
Усунення несправностей
Чому потрібен Git?
Чому потрібен Git?
Git потрібен для методу встановлення
git. Для встановлень через npm Git усе одно перевіряється/встановлюється, щоб уникнути збоїв spawn git ENOENT, коли залежності використовують git URL.Чому npm отримує EACCES у Linux?
Чому npm отримує EACCES у Linux?
Деякі конфігурації Linux спрямовують глобальний префікс npm на шляхи, що належать root.
install.sh може перемкнути префікс на ~/.npm-global і додати експорти PATH до shell rc-файлів (коли ці файли існують).Проблеми sharp/libvips
Проблеми sharp/libvips
Скрипти типово задають
SHARP_IGNORE_GLOBAL_LIBVIPS=1, щоб уникнути збирання sharp із системним libvips. Щоб перевизначити:Windows: "npm error spawn git / ENOENT"
Windows: "npm error spawn git / ENOENT"
Встановіть Git for Windows, знову відкрийте PowerShell і повторно запустіть інсталятор.
Windows: "openclaw is not recognized"
Windows: "openclaw is not recognized"
Запустіть
npm config get prefix і додайте цей каталог до свого користувацького PATH (у Windows суфікс \bin не потрібен), потім знову відкрийте PowerShell.Windows: як отримати докладний вивід інсталятора
Windows: як отримати докладний вивід інсталятора
install.ps1 наразі не надає перемикач -Verbose.
Використовуйте трасування PowerShell для діагностики на рівні скрипта:openclaw не знайдено після встановлення
openclaw не знайдено після встановлення
Зазвичай це проблема PATH. Див. усунення несправностей Node.js.