Установка

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

• Node 24 (рекомендуется) или Node 22.19+ - установочный скрипт обрабатывает это автоматически
• macOS, Linux или Windows - пользователи Windows могут начать с нативного приложения Windows Hub, установщика CLI для PowerShell или WSL2 Gateway. См. 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 checkout в рамках того же потока с префиксом. Полная справка: Внутреннее устройство установщика.

Уже установлено? Переключайтесь между установками из пакета и из 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

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

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

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

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

Установка из checkout основной ветки GitHub

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

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

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

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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

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

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

Разверните OpenClaw на облачном сервере или VPS:

Обновление, миграция или удаление

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

Если установка прошла успешно, но openclaw не найден в вашем терминале:

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

Если $(npm prefix -g)/bin отсутствует в вашем $PATH, добавьте его в файл запуска вашей оболочки (~/.zshrc или ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Затем откройте новый терминал. Подробнее см. в разделе Настройка Node.