Skip to main content

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

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

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

Самый быстрый способ установки. Он определяет вашу ОС, при необходимости устанавливает Node, устанавливает OpenClaw и запускает первоначальную настройку.
Пользователи настольной версии Windows также могут установить нативное вспомогательное приложение Windows Hub, которое включает первоначальную настройку, отображение состояния в системном трее, чат, режим Node и локальный режим MCP.
Чтобы установить без запуска первоначальной настройки:
Все флаги и параметры для CI и автоматизации описаны в разделе Внутреннее устройство установщика.

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

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

Используйте этот способ, если хотите разместить OpenClaw и Node под локальным префиксом, например ~/.openclaw, не завися от общесистемной установки Node:
По умолчанию поддерживается установка через npm, а также установка из рабочей копии git в рамках того же процесса с префиксом. Полная справка: Внутреннее устройство установщика. Уже установили? Переключайтесь между установками из пакета и git с помощью openclaw update --channel dev и openclaw update --channel stable. См. Обновление.

​
npm, pnpm или bun

Если вы самостоятельно управляете Node:
Размещённый установщик сбрасывает фильтры актуальности npm, такие как min-release-age, при установке пакета OpenClaw. Если вы устанавливаете его вручную через npm, продолжает действовать ваша собственная политика npm.

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

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

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

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

Docker

Развёртывание в контейнере или без графического интерфейса.

Podman

Альтернатива Docker для контейнеров без прав root.

Nix

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

Ansible

Автоматизированное развёртывание на группе машин.

Bun

Необязательный установщик зависимостей и средство запуска скриптов пакетов.

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

Если после установки требуется управляемый запуск:
  • 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.

VPS

Выберите провайдера.

Виртуальная машина Docker

Общие шаги для Docker.

Kubernetes

Развёртывание в K8s.

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

Обновление

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

Перенос

Перенесите OpenClaw на новый компьютер.

Удаление

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

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

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