Установка

Системные требования

• Node 22.22.3+, 24.15+ или 25.9+ — Node 24 является целевой версией по умолчанию; установочный скрипт настраивает её автоматически.
• macOS, Linux или Windows — пользователи Windows могут начать с нативного приложения Windows Hub, установщика CLI для PowerShell или Gateway в WSL2. См. раздел Windows.
• pnpm требуется только при сборке из исходного кода.

Рекомендуемый способ: установочный скрипт

Самый быстрый способ установки. Он определяет вашу ОС, при необходимости устанавливает Node, устанавливает OpenClaw и запускает первоначальную настройку.

curl -fsSL https://openclaw.ai/install.sh | bash

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

Чтобы установить без запуска первоначальной настройки:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

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

Все флаги и параметры для CI и автоматизации описаны в разделе Внутреннее устройство установщика.

Альтернативные способы установки

Установщик с локальным префиксом (install-cli.sh)

Используйте этот способ, если хотите разместить OpenClaw и Node под локальным префиксом, например ~/.openclaw, не завися от общесистемной установки Node:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

По умолчанию поддерживается установка через npm, а также установка из рабочей копии git в рамках того же процесса с префиксом. Полная справка: Внутреннее устройство установщика.

Уже установили? Переключайтесь между установками из пакета и git с помощью openclaw update --channel dev и openclaw update --channel stable. См. Обновление.

npm, pnpm или bun

Если вы самостоятельно управляете Node:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Из исходного кода

Для участников разработки и всех, кто хочет запускать OpenClaw из локальной рабочей копии:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Либо пропустите создание ссылки и используйте pnpm openclaw ... внутри репозитория. Полные сведения о рабочих процессах разработки см. в разделе Настройка.

Установка из основной рабочей копии GitHub

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

Контейнеры и менеджеры пакетов

Проверка установки

openclaw --version      # проверьте доступность CLIopenclaw doctor         # проверьте наличие проблем с конфигурациейopenclaw gateway status # убедитесь, что Gateway запущен

Если после установки требуется управляемый запуск:

• macOS: LaunchAgent через openclaw onboard --install-daemon или openclaw gateway install
• Linux/WSL2: пользовательская служба systemd через те же команды
• Нативная Windows: сначала Scheduled Task, а если создание задачи запрещено — резервный вариант в виде элемента входа в папке Startup для текущего пользователя

Хостинг и развёртывание

Разверните OpenClaw на облачном сервере или VPS. Полный список вариантов провайдеров (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi и другие) приведён в разделе Сервер Linux; также можно выполнить декларативное развёртывание на Render.

Обновление, перенос или удаление

Устранение неполадок: openclaw не найден

Почти всегда проблема связана с PATH: каталог глобальных исполняемых файлов npm отсутствует в PATH вашей оболочки. Полное решение, включая путь в Windows, приведено в разделе Устранение неполадок Node.js.

node -v           # установлен ли Node?npm prefix -g     # где находятся глобальные пакеты?echo "$PATH"      # присутствует ли каталог глобальных исполняемых файлов в PATH?