Установка
Уже прошли Начало работы? Тогда всё готово — эта страница посвящена альтернативным способам установки, инструкциям для конкретных платформ и обслуживанию.Системные требования
- Node 22+ (скрипт-установщик из раздела способы установки установит его при отсутствии)
- macOS, Linux или Windows
pnpm— только при сборке из исходников
В Windows настоятельно рекомендуется запускать OpenClaw под WSL2.
Способы установки
Installer script
Installer script
Загружает CLI, устанавливает его глобально через npm и запускает мастер первичной настройки.
npm / pnpm
npm / pnpm
Если у вас уже есть Node 22+ и вы предпочитаете управлять установкой самостоятельно:
From source
From source
Для контрибьюторов или тех, кто хочет запускать из локального репозитория.
Другие способы установки
Docker
Контейнеризованные или headless-развёртывания.
Podman
Rootless-контейнер: выполните
setup-podman.sh один раз, затем запустите скрипт запуска.Nix
Декларативная установка через Nix.
Ansible
Автоматизированное развёртывание парка.
Bun
Использование только CLI через рантайм Bun.
После установки
Проверьте, что всё работает:OPENCLAW_HOMEfor home-directory based internal pathsOPENCLAW_STATE_DIRfor mutable state locationOPENCLAW_CONFIG_PATHfor config file location
Устранение неполадок: openclaw не найден
PATH diagnosis and fix
PATH diagnosis and fix
Быстрая диагностика:Если В Windows добавьте вывод команды
$(npm prefix -g)/bin (macOS/Linux) или $(npm prefix -g) (Windows) отсутствует в вашем $PATH, оболочка не может найти глобальные бинарные файлы npm (включая openclaw).Исправление — добавьте его в файл инициализации вашей оболочки (~/.zshrc или ~/.bashrc):npm prefix -g в PATH.Затем откройте новый терминал (или выполните rehash в zsh / hash -r в bash).Обновление / удаление
Updating
Поддерживайте OpenClaw в актуальном состоянии.
Migrating
Перенос на новую машину.
Uninstall
Полностью удалить OpenClaw.