Перейти к основному содержанию

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

  • Node 24 (рекомендуется) или Node 22.19+ - установочный скрипт обрабатывает это автоматически
  • macOS, Linux или Windows - пользователи Windows могут начать с нативного приложения Windows Hub, установщика CLI для PowerShell или WSL2 Gateway. См. Windows.
  • pnpm нужен только при сборке из исходного кода

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

Самый быстрый способ установки. Он определяет вашу ОС, при необходимости устанавливает Node, устанавливает OpenClaw и запускает первичную настройку.
Пользователи Windows на настольных компьютерах также могут установить нативное сопутствующее приложение Windows Hub, которое включает настройку, статус в трее, чат, режим узла и локальный режим MCP.
curl -fsSL https://openclaw.ai/install.sh | bash
Чтобы установить без запуска первичной настройки: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Все флаги и параметры 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@latest
openclaw onboard --install-daemon
Размещенный установщик сбрасывает фильтры свежести npm, такие как min-release-age, для установки пакета OpenClaw. Если вы устанавливаете вручную через npm, ваша собственная политика npm все равно применяется.

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

Для участников разработки или всех, кто хочет запускать из локального checkout: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw 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

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

Docker

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

Podman

Rootless-альтернатива Docker для контейнеров.

Nix

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

Ansible

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

Bun

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

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

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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:

VPS

Любой Linux VPS.

Docker VM

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

Kubernetes

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

Fly.io

Развертывание на Fly.io.

Hetzner

Развертывание в Hetzner.

GCP

Развертывание в Google Cloud.

Azure

Развертывание в Azure.

Railway

Развертывание в Railway.

Render

Развертывание в Render.

Northflank

Развертывание в Northflank.

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

Обновление

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

Миграция

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

Удаление

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

​
Устранение неполадок: 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.