Установка OpenClaw на macOS и Linux: пошаговая инструкция

Перед установкой OpenClaw убедитесь, что ваша система соответствует минимальным требованиям. OpenClaw - это Node.js-приложение, поэтому основное требование связано с версией среды выполнения.

Обязательные требования: Node.js версии 24 (рекомендуется) или Node.js 22.19 и выше. npm версии 9 или новее (устанавливается вместе с Node.js). Операционная система: macOS 12 Monterey и выше, или любой современный дистрибутив Linux (Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch Linux). Минимум 4 ГБ оперативной памяти (8 ГБ рекомендуется). Стабильное интернет-соединение (при использовании облачных LLM-провайдеров).

Рекомендуемые инструменты: git (для сборки из исходников), pnpm (для разработки), любой терминал с поддержкой UTF-8.

Актуальная версия: Текущая стабильная версия v2026.7.1 (выпущена 6 июля 2026). Эта версия исправляет критическую регрессию tool-execution (баг #98528) из v2026.6.11: инструменты web_search, exec и web_fetch снова работают корректно.

Откройте терминал и выполните команду для проверки установленной версии Node.js:

node --version

Если команда возвращает версию ниже 22.19, вам необходимо обновить Node.js. Рекомендуется использовать менеджер версий nvm (Node Version Manager) для управления версиями Node.js.

Если у вас ещё не установлен nvm, выполните следующую команду:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

После установки перезапустите терминал или выполните:

source ~/.bashrc

Для пользователей macOS с zsh вместо этого выполните:

source ~/.zshrc

Теперь установите рекомендуемую версию Node.js:

nvm install 24
nvm use 24

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

node --version
npm --version

Самый простой способ установить OpenClaw - использовать пакетный менеджер npm. Выполните одну команду:

npm install -g openclaw@latest

Флаг -g устанавливает пакет глобально, что позволяет запускать команду openclaw из любой директории. Флаг @latest гарантирует установку самой свежей версии.

Если вы предпочитаете pnpm (более быстрый альтернативный менеджер пакетов), используйте:

pnpm install -g openclaw@latest

После установки проверьте, что OpenClaw доступен в системе:

openclaw --version

Команда должна вывести текущую версию пакета, например: openclaw v2026.7.1.

На macOS при глобальной установке через npm вы можете столкнуться с ошибкой доступа EACCES. Это связано с правами на директорию, куда npm устанавливает глобальные пакеты. Есть два решения.

Первое решение - использовать nvm, который устанавливает Node.js в домашнюю директорию пользователя и не требует sudo. Если вы установили Node.js через nvm (как описано выше), проблем с правами не будет.

Второе решение - изменить директорию глобальных пакетов npm:

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

Добавьте последнюю строку в ваш файл ~/.zshrc или ~/.bash_profile, чтобы изменение сохранилось между сессиями.

На macOS также может потребоваться установка Xcode Command Line Tools, если они ещё не установлены:

xcode-select --install

На большинстве дистрибутивов Linux установка через npm проходит без проблем при использовании nvm. Если вы устанавливали Node.js через системный пакетный менеджер (apt, dnf, pacman), глобальная установка npm-пакетов может требовать sudo:

sudo npm install -g openclaw@latest

Однако использование sudo для npm install не рекомендуется из соображений безопасности. Лучше установите Node.js через nvm.

На некоторых дистрибутивах Linux может потребоваться установка дополнительных зависимостей для нативных модулей Node.js:

# Ubuntu / Debian
sudo apt update
sudo apt install build-essential python3

# Fedora
sudo dnf groupinstall 'Development Tools'
sudo dnf install python3

# Arch Linux
sudo pacman -S base-devel python

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

Клонируйте репозиторий с GitHub:

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

Установите зависимости с помощью pnpm (OpenClaw использует pnpm в качестве менеджера пакетов для разработки):

npm install -g pnpm
pnpm install

Соберите проект:

pnpm run build

После успешной сборки вы можете запустить OpenClaw напрямую из директории проекта:

node dist/index.js --version

Для удобства использования создайте символическую ссылку:

pnpm link --global

Теперь команда openclaw будет доступна глобально и указывать на вашу локальную сборку.

После установки любым способом выполните серию проверочных команд:

openclaw --version
openclaw --help

Команда --version выводит текущую версию. Команда --help показывает список доступных подкоманд и флагов. Если обе команды отрабатывают без ошибок, установка прошла успешно.

Проблема: команда openclaw не найдена после установки. Убедитесь, что директория глобальных npm-пакетов добавлена в переменную PATH. Выполните npm config get prefix и проверьте, что путь bin внутри этой директории есть в вашем PATH.

Проблема: ошибка ENOENT при установке. Обычно вызвана отсутствием git или build-essential. Установите необходимые зависимости для вашей ОС (см. раздел про Linux выше).

Проблема: ошибка несовместимой версии Node.js. OpenClaw требует Node.js 22.19 или выше (рекомендуется Node.js 24, начиная с OpenClaw 2026.5.x). Проверьте версию командой node --version и обновите при необходимости через nvm.

Проблема: медленная установка или таймауты. Попробуйте использовать альтернативный реестр npm или прокси. Также убедитесь, что ваше интернет-соединение стабильно. Для ускорения можно использовать pnpm вместо npm.

Для обновления OpenClaw до последней версии выполните ту же команду установки:

Если вы собирали из исходников, обновите репозиторий и пересоберите:

cd openclaw
git pull origin main
pnpm install
pnpm run build

Рекомендуется следить за релизами на странице GitHub Releases, где публикуются заметки о новых версиях, исправлениях ошибок и критических обновлениях безопасности.

После успешной установки OpenClaw переходите к статье о первом запуске и начальной настройке, где мы подробно разберём процесс онбординга и конфигурации вашего AI-агента.

Требования к Node.js обновлены: теперь рекомендуется Node 24 (ранее Node 22.14+). Node 24 принёс значительные улучшения производительности для асинхронных операций, которые активно использует OpenClaw. Установить Node 24 можно через nvm: 'nvm install 24 && nvm use 24'.

Уточнённые аппаратные требования для стабильной работы: минимум 8 ГБ RAM для базовой конфигурации, 16 ГБ RAM рекомендуется для мультиагентных сценариев. На Apple Silicon M3 и выше Task Brain работает значительно быстрее благаря оптимизации SQLite под unified memory архитектуру.

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

ВНИМАНИЕ: Эти инструкции устарели. OpenClaw является Node.js-приложением и не требует Python или venv. Правильная канонная установка: npm install -g openclaw

npm install

cp config.example.yaml config.yaml

Откройте config.yaml в любом текстовом редакторе. Обязательные параметры:

Опциональные параметры: memory.enabled (включить долгосрочную память), tools (список доступных инструментов), heartbeat.interval (частота автономных действий агента).

Запустите OpenClaw командой: openclaw gateway

Вы должны увидеть в логах:

Если видите эти строки -- OpenClaw работает. Отправьте тестовое сообщение вашему агенту через настроенный канал.

Telegram -- наиболее популярный канал для OpenClaw. Настройка:

OpenClaw поддерживает плагины через API defineToolPlugin. Создайте файл plugins/my_tool.py:

from openclaw import defineToolPlugin

@defineToolPlugin(name="weather", description="Get current weather")
def get_weather(city: str) -> str:
# Ваша логика
return f"Weather in {city}: sunny, 25C"

После добавления файла перезапустите OpenClaw -- плагин автоматически зарегистрируется. Агент сможет использовать новый инструмент в разговорах. Это позволяет добавлять любую кастомную логику: запросы к корпоративным системам, базам данных, внешним API.

Для обновления до последней версии:

Перед обновлением сделайте резервную копию config.yaml -- изредка структура конфигурации меняется между версиями. Changelog доступен на github.com/openclaw/openclaw/releases.

Начиная с OpenClaw 2026.5.x, рекомендуемой версией Node.js стала Node.js 24 (не просто «поддерживаемая», а именно рекомендуемая по умолчанию). Минимальная версия по-прежнему 22.19+. Обновление до Node 24:

nvm install 24 && nvm use 24 && nvm alias default 24

Если nvm не установлен: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

OpenClaw 2026.5.x добавил упрощённую установку LaunchAgent для автозапуска на macOS. После глобальной установки (npm install -g openclaw) выполните:

openclaw onboard --install-daemon

Команда автоматически создаёт и регистрирует ~/Library/LaunchAgents/ai.openclaw.agent.plist. После этого OpenClaw запускается автоматически при входе в систему и перезапускается при сбоях.

Проверить статус: launchctl list | grep openclaw. Удалить daemon: openclaw onboard --uninstall-daemon.

Начиная с OpenClaw v2026.6.1 (3 июня 2026), Windows является первоклассной платформой наравне с macOS и Linux. Доступны подписанные установщики для Windows 10 и Windows 11.

Системные требования для Windows: Windows 10 (версия 1903 и выше) или Windows 11. Node.js 22.19+ или Node.js 24 LTS (рекомендуется). npm 9+. 4 ГБ RAM минимум, 8 ГБ рекомендуется. PowerShell 5.1+ (входит в Windows 10/11 по умолчанию).

Установка через PowerShell (рекомендуемый способ):

Альтернативно - через winget (Windows Package Manager):

winget install openclaw

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

Особенности установки на Windows: если PowerShell выдаёт ошибку политики выполнения скриптов, выполните: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser. При ошибке EACCES при глобальной установке используйте PowerShell с правами администратора. Node.js на Windows лучше всего устанавливать через официальный установщик с nodejs.org или через nvm-windows.

Важное исправление: OpenClaw является Node.js-приложением, а не Python. Правильная команда запуска шлюза: openclaw gateway. Предыдущий вариант с python3 main.py был ошибочным и удалён из инструкции.

Обновление до v2026.7.1 (6 июля 2026): npm update -g openclaw или npx openclaw@2026.7.1. В этой версии: исправлена регрессия tool-execution (баг #98528), улучшенная стабильность MCP-инструментов, усиленная безопасность каналов, поддержка параллельного веб-поиска. Для Windows: обновлённые подписанные установщики доступны на openclaw.ai.

Регрессия tool-execution (баг #98528) исправлена в v2026.7.1. Если вы используете v2026.6.11, обновитесь командой npm update -g openclaw. Версия v2026.7.1 включает все улучшения безопасности из v2026.6.10 (транскрипты, sandbox, MCP stdio) и исправленный tool-execution.

Для установки на macOS и Linux используйте актуальную версию v2026.7.1: npm install -g openclaw@2026.7.1 или npm install -g openclaw@latest. Эта версия исправляет регрессию tool-execution (баг #98528) из v2026.6.11 и рекомендуется для всех пользователей.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.