Skip to main content

Установка

Уже прошли Начало работы? Тогда всё готово — эта страница посвящена альтернативным способам установки, инструкциям для конкретных платформ и обслуживанию.

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

  • Node 22+ (скрипт-установщик из раздела способы установки установит его при отсутствии)
  • macOS, Linux или Windows
  • pnpm — только при сборке из исходников
В Windows настоятельно рекомендуется запускать OpenClaw под WSL2.

Способы установки

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

Installer script

Загружает CLI, устанавливает его глобально через npm и запускает мастер первичной настройки.
Если у вас уже есть Node 22+ и вы предпочитаете управлять установкой самостоятельно:
Для контрибьюторов или тех, кто хочет запускать из локального репозитория.

Другие способы установки

Docker

Контейнеризованные или headless-развёртывания.

Podman

Rootless-контейнер: выполните setup-podman.sh один раз, затем запустите скрипт запуска.

Nix

Декларативная установка через Nix.

Ansible

Автоматизированное развёртывание парка.

Bun

Использование только CLI через рантайм Bun.

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

Проверьте, что всё работает:
If you need custom runtime paths, use:
  • OPENCLAW_HOME for home-directory based internal paths
  • OPENCLAW_STATE_DIR for mutable state location
  • OPENCLAW_CONFIG_PATH for config file location
See Environment vars for precedence and full details.

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

Быстрая диагностика:
Если $(npm prefix -g)/bin (macOS/Linux) или $(npm prefix -g) (Windows) отсутствует в вашем $PATH, оболочка не может найти глобальные бинарные файлы npm (включая openclaw).Исправление — добавьте его в файл инициализации вашей оболочки (~/.zshrc или ~/.bashrc):
В Windows добавьте вывод команды npm prefix -g в PATH.Затем откройте новый терминал (или выполните rehash в zsh / hash -r в bash).

Обновление / удаление

Updating

Поддерживайте OpenClaw в актуальном состоянии.

Migrating

Перенос на новую машину.

Uninstall

Полностью удалить OpenClaw.