Обзор установки

Установка

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

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

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

ℹ️ В Windows настоятельно рекомендуем запускать OpenClaw под WSL2.

Методы установки

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

⚠️ Для VPS/облачных хостов по возможности избегайте сторонних образов из маркетплейсов «в 1 клик». Предпочтительнее чистый базовый образ ОС (например, Ubuntu LTS), затем установите OpenClaw самостоятельно с помощью скрипта установщика.

Другие методы установки

Docker

Контейнеризированные или безголовые развертывания.

Podman

Контейнер без прав root: запустите setup-podman.sh один раз, затем скрипт запуска.

Nix

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

Ansible

Автоматизированная подготовка парка машин.

Bun

Только CLI через среду выполнения Bun.

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

Проверьте, что всё работает:

openclaw doctor         # проверить наличие проблем с конфигурацией
openclaw status         # статус шлюза
openclaw dashboard      # открыть веб-интерфейс

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

  • OPENCLAW_HOME для внутренних путей, основанных на домашнем каталоге
  • OPENCLAW_STATE_DIR для расположения изменяемого состояния
  • OPENCLAW_CONFIG_PATH для расположения файла конфигурации

См. Переменные окружения для порядка приоритета и полных деталей.

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

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

Обновление

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

Миграция

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

Удаление

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

Внутреннее устройство установщика