Как установить OpenClaw — Полное руководство по установке для Windows, Mac и Linux

Установка OpenClaw занимает около 5 минут. Вам понадобятся Node.js 22+, Git и 8 ГБ оперативной памяти. Самый быстрый способ — одна команда npm install -g openclaw@latest, после которой запускается мастер настройки. Также можно полностью пропустить установку, воспользовавшись управляемым хостингом MyClaw.ai.

Что нужно перед установкой OpenClaw

Перед установкой OpenClaw на вашу машину убедитесь в наличии следующих требований:

ТребованиеМинимумРекомендуемоеОЗУ8 ГБ16 ГБХранилище10 ГБ20 ГБNode.jsv22v22+ (последний LTS)ОСWin 10 (WSL2) / macOS 12 / Ubuntu 20.04Последняя стабильная версия

Вариант 1: Пропустить установку с управляемым хостингом

Не хотите возиться с установкой? MyClaw.ai предлагает полностью управляемый хостинг OpenClaw — ваш экземпляр готов за секунды без какой-либо настройки:

• Мгновенная настройка — Без установки, без конфигурации, без команд в терминале
• Всегда работает — Доступность 24/7 без необходимости держать компьютер включённым
• Автоматические обновления — Всегда работает последняя версия OpenClaw

Начать работу с MyClaw.ai →

---

Вариант 2: Самостоятельный хостинг OpenClaw

Есть два способа самостоятельного хостинга: рекомендуемая глобальная установка (самый простой) или сборка из исходного кода (для разработчиков).

Рекомендуется: Глобальная установка

Это самый быстрый способ запустить OpenClaw на любой платформе:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Мастер настройки проведёт вас через конфигурацию шлюза, рабочего пространства, каналов и навыков. Флаг --install-daemon настраивает фоновую службу (launchd на macOS, systemd на Linux), чтобы OpenClaw работал постоянно.

После настройки проверьте вашу установку:

openclaw doctor

---

Альтернатива: Сборка из исходного кода

Если вы предпочитаете полный контроль или хотите внести вклад в OpenClaw, вы можете собрать из исходного кода. Следуйте руководствам для конкретных платформ ниже.

Установка OpenClaw на Windows

Настоятельно рекомендуется WSL2 для запуска OpenClaw на Windows. Сначала установите WSL2, затем следуйте инструкциям для Linux ниже.

Если вы всё же хотите запускать нативно на Windows:

Шаг 1: Установка необходимых компонентов

1. Скачайте Node.js v22+ (LTS-версия)
2. Скачайте Git для Windows
3. Установите pnpm — предпочтительный менеджер пакетов OpenClaw
4. Перезапустите терминал после установки

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

node --version   # Должно быть v22 или новее
git --version
pnpm --version

Шаг 2: Клонирование репозитория OpenClaw

Откройте PowerShell или командную строку и выполните:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Шаг 3: Установка и сборка

pnpm install
pnpm ui:build
pnpm build

Это загружает все необходимые пакеты и собирает проект.

Шаг 4: Запуск мастера настройки

pnpm openclaw onboard --install-daemon

Мастер проведёт вас через настройку OpenClaw, включая конфигурацию ИИ-модели, каналов и рабочего пространства.

Установка OpenClaw на macOS

Шаг 1: Установка необходимых компонентов

Самый простой способ — через Homebrew:

# Установите Homebrew, если нужно
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Установите Node.js и Git
brew install node git

# Установите pnpm
brew install pnpm

Шаг 2: Клонирование и сборка

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Шаг 3: Запуск мастера настройки

pnpm openclaw onboard --install-daemon

Это настраивает службу launchd, чтобы OpenClaw автоматически работал в фоновом режиме.

Разрешения macOS

OpenClaw может запросить разрешения для записи экрана и голосовых функций. При появлении запроса перейдите в:

Системные настройки > Конфиденциальность и безопасность > Универсальный доступ

Добавьте ваше приложение терминала в список разрешённых.

Установка OpenClaw на Linux (Ubuntu/Debian)

Шаг 1: Установка необходимых компонентов

# Обновить менеджер пакетов
sudo apt update

# Установить Node.js 22 через NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Установить Git
sudo apt install -y git

# Установить pnpm
npm install -g pnpm

Шаг 2: Клонирование и сборка

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Шаг 3: Запуск мастера настройки

pnpm openclaw onboard --install-daemon

Это настраивает пользовательскую службу systemd, чтобы OpenClaw постоянно работал в фоновом режиме.

Устранение распространённых проблем с установкой

"pnpm install" завершается с ошибками прав доступа

На Linux/macOS не используйте sudo с pnpm или npm. Вместо этого исправьте права доступа:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Ошибка "Версия Node не поддерживается"

OpenClaw требует Node.js 22 или новее:

node --version

Если ваша версия устарела, скачайте последнюю с nodejs.org или используйте nvm для управления версиями:

nvm install 22
nvm use 22

Порт уже используется

Другое приложение использует тот же порт. Вы можете:

• Остановить конфликтующее приложение
• Указать другой порт: openclaw gateway --port 18790

Отсутствующие нативные зависимости

На Linux вам могут потребоваться дополнительные инструменты сборки:

sudo apt install build-essential

Запуск инструмента диагностики

OpenClaw включает встроенную команду диагностики, которая проверяет вашу конфигурацию:

openclaw doctor

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

После установки OpenClaw запустите инструмент диагностики, чтобы убедиться, что всё работает:

openclaw doctor

Затем протестируйте простой командой агента:

openclaw agent --message "Привет, ты работаешь?"

Если OpenClaw ответит, установка завершена.

Обновление OpenClaw

Чтобы обновить вашу установку OpenClaw до последней версии:

Если установлен глобально:

openclaw update --channel stable

Если собран из исходного кода:

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

Дальнейшие шаги

Теперь, когда OpenClaw установлен:

• Прочитайте Руководство по началу работы, чтобы узнать основы использования
• Узнайте больше о том, Что такое OpenClaw
• Изучите варианты хостинга OpenClaw для работы 24/7