Как установить OpenClaw на Mac, Windows, Linux и сервер

OpenClaw — ИИ-ассистент с открытым исходным кодом, который работает на вашем компьютере или сервере: с ним можно общаться в браузере и через мессенджеры. Раньше проект назывался Clawdbot, затем Moltbot, а нынешнее имя получил в январе 2026 года, поэтому в старых инструкциях встречаются оба прежних названия.

Проще всего поставить OpenClaw одной командой. Скрипт сам установит Node.js, если подходящей версии нет, поставит OpenClaw и запустит первоначальную настройку:

# macOS, Linux, WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows, PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

Если терминал не нужен, возьмите приложение для macOS, Windows или Linux на странице установки: оно само ставит Gateway — основной процесс OpenClaw, через который идут чаты и подключения к мессенджерам, — и проводит настройку. В любом случае понадобится доступ к модели: вход в Claude Code или Codex CLI либо API-ключ провайдера.

После установки из терминала выполните openclaw gateway install, чтобы Gateway работал в фоне, а не в открытом окне, и проверьте его командой openclaw gateway status. Если на машине стоит старый пакет clawdbot, сначала прочитайте раздел о переходе: этот пакет остановился на январской версии. Установку OpenClaw старше июня 2026 года не обновляйте сразу до последней версии — нужен промежуточный шаг. Команды и версии ниже приведены по состоянию на 24 сентября 2026 года.

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

Требования по документации и странице установки на 24 сентября 2026 года:

Ставить Node.js заранее не нужно: если подходящей версии нет, скрипт установит Node 26 через Homebrew на macOS, Node 24 LTS через NodeSource на Linux, а в Windows возьмёт Node через winget, Chocolatey или Scoop (как устроен установщик). Node 26 разработчики рекомендуют потому, что Gateway на нём стартует заметно быстрее и расходует меньше памяти, чем на Node 24 (совместимость с Node.js). Требование «Node 22» из старых инструкций соответствует январским сборкам: пакет clawdbot объявлял Node 22.12+, а нынешнему openclaw нужен Node 24 не ниже 24.16 или Node 26 не ниже 26.1. На 32-битных системах ARMv7 установка не запустится: официальных сборок Node 24+ под эту архитектуру нет.

Русская версия страницы «Установка» отстаёт от английской: по состоянию на 24 сентября 2026 года в ней ещё указаны Node 22.22.3+, 24.15+ или 25.9+, команда npm без флага --allow-scripts и pnpm approve-builds -g, который для глобальной установки не поддерживается. Версии и флаги сверяйте с английской страницей.

Какой способ установки выбрать

Выбор зависит от трёх условий: готовы ли вы пользоваться терминалом, где будет запущен Gateway и должен ли ассистент быть доступен круглосуточно.

Docker на своём компьютере не обязателен: документация рекомендует его для изолированной или одноразовой среды и для хостов, где не хочется ничего ставить локально. Если это ваш рабочий компьютер, обычная установка проще.

Установка на macOS и Linux

Сама установка, по оценке разработчиков, занимает около двух минут.

1. Запустите скрипт:

   bash

   curl -fsSL https://openclaw.ai/install.sh | bash

   Он определяет систему, при необходимости ставит Node.js и Git, устанавливает пакет openclaw через npm и запускает первоначальную настройку. На macOS первый запуск может запросить пароль администратора: так ставится Homebrew, если он нужен для Node или Git. На Linux скрипт работает в Debian, Ubuntu, Fedora, Arch и Raspberry Pi OS.

2. Пройдите первоначальную настройку. Вариант Quick start подходит, если на машине уже есть вход в Claude Code или Codex CLI либо API-ключ: OpenClaw найдёт их, проверит настоящим запросом к модели, сохранит конфигурацию и откроет панель управления. Если рабочего доступа не нашлось, мастер переходит к ручной настройке провайдера. Custom setup проводит по всем параметрам. Вернуться к настройкам позже можно командой openclaw configure (Начало работы).

3. Переведите Gateway в фон. После Quick start Gateway работает в текущем окне терминала. Остановите его сочетанием Ctrl+C и установите службу:

   bash

   openclaw gateway install

   На macOS это LaunchAgent, на Linux — пользовательская служба systemd. Конфигурация при остановке и установке службы сохраняется.

4. Проверьте результат командами из раздела о проверке.

Чтобы поставить OpenClaw без мастера, например из скрипта автоматизации, добавьте флаг --no-onboard: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard. Настройку потом запускает openclaw onboard.

Для Ubuntu с рабочим столом есть приложение в форматах .deb и AppImage (только x64). Им нужна glibc 2.35 или новее, то есть Ubuntu 22.04+ или Debian 12; RHEL 9 и Rocky Linux 9 не подойдут. AppImage требует FUSE 2: sudo apt install libfuse2, а в Ubuntu 24.04 и новее — libfuse2t64 (документация по Linux).

Установка на сервер или VPS с Ubuntu

На сервере работает тот же скрипт, но к нему добавляются две задачи: служба должна продолжать работу после выхода из SSH, а панель управления лучше открывать через туннель, а не через открытый порт.

1. Подключитесь к серверу по SSH под обычным пользователем с правами sudo. Состояние и настройки OpenClaw хранятся в домашнем каталоге того, кто запускает Gateway (по умолчанию ~/.openclaw), а в описании системной службы документация прямо называет запуск Gateway от root небезопасным. Если на новом VPS есть только root, создайте пользователя: adduser <user> и usermod -aG sudo <user>.

2. Установите OpenClaw и пройдите настройку в терминале:

   bash

   curl -fsSL https://openclaw.ai/install.sh | bash

3. Если после Quick start Gateway остался работать в окне терминала, остановите его сочетанием Ctrl+C. Затем установите службу и проверьте её:

   bash

   openclaw gateway install
   openclaw gateway status

4. Включите режим linger: с ним systemd не останавливает службы пользователя, когда тот выходит из системы. Без него Gateway не переживёт закрытие SSH-сессии:

   bash

   sudo loginctl enable-linger $(whoami)

   Для сервера с одним пользователем руководство по Gateway называет это поддерживаемым способом держать Gateway запущенным без входа в систему. Если на сервере без рабочего стола команды systemctl --user не срабатывают, выполните export XDG_RUNTIME_DIR=/run/user/$(id -u) и повторите.

5. Откройте панель через SSH-туннель. По умолчанию Gateway слушает только локальный адрес сервера (loopback, 127.0.0.1), и так безопаснее всего. На своём компьютере выполните:

   bash

   ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

   Затем откройте в браузере http://127.0.0.1:18789/ и войдите с токеном Gateway. Одноразовую ссылку для входа выдаёт команда openclaw dashboard --json на сервере: поле browserUrl действует десять минут.

Не открывайте порт 18789 в интернет. Если Gateway всё-таки должен слушать сеть (режимы lan или tailnet), он требует общий секрет — токен или пароль. Вместо туннеля можно использовать Tailscale Serve (Linux server). На той же странице собраны инструкции для DigitalOcean, Hetzner, Hostinger, Oracle Cloud, Fly.io, Railway, Render и других площадок.

Установка в Windows

Документация по Windows описывает три пути: для рабочего компьютера проще всего Windows Hub, для работы из терминала — скрипт PowerShell, для максимальной совместимости с Linux — WSL2.

Windows Hub: приложение без терминала

Windows Hub — приложение для Windows 10 20H2+ и Windows 11, которое ставится без прав администратора. Скачайте OpenClawCompanion-Setup-x64.exe или OpenClawCompanion-Setup-arm64.exe со страницы установки или из релизов Windows Hub. При первом запуске выберите Set up locally: приложение создаст собственный дистрибутив WSL OpenClawGateway, установит в него Gateway и подключится к нему, не трогая ваш Ubuntu в WSL, если он есть. Когда значок в области уведомлений станет зелёным, настройка закончена.

Если локальная настройка не проходит, частые причины — выключенный WSL, заблокированная виртуализация, остатки прежней WSL-установки приложения или обрыв сети при загрузке Gateway. Журнал настройки открывается так:

notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

PowerShell: CLI и Gateway прямо в Windows

iwr -useb https://openclaw.ai/install.ps1 | iex

Скрипт ставит Node через winget, Chocolatey или Scoop, а если это не удаётся — скачивает переносимую сборку Node 26. Без мастера настройки установка запускается так:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1 ))) -NoOnboard

Как и на macOS, после Quick start остановите Gateway в окне PowerShell сочетанием Ctrl+C и выполните openclaw gateway install: Gateway будет запускаться задачей Планировщика заданий, а если создать задачу нельзя — через элемент в папке автозагрузки. Проверка — openclaw gateway status --json. Если PowerShell не находит команду openclaw, выполните npm config get prefix, добавьте этот каталог в PATH пользователя и откройте PowerShell заново.

WSL2: самый совместимый с Linux вариант

В PowerShell установите дистрибутив:

wsl --install -d Ubuntu-24.04

Внутри WSL включите systemd:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

Перезапустите WSL командой wsl --shutdown в PowerShell и внутри дистрибутива выполните обычную установку для Linux: curl -fsSL https://openclaw.ai/install.sh | bash. Если Gateway в WSL должен стартовать ещё до входа в Windows, понадобятся linger и отдельная задача в Планировщике заданий — порядок описан в разделе Gateway auto-start before Windows login той же документации.

Установка через Docker

Docker подходит, если Gateway должен работать в изолированной среде или на хосте, где вы не хотите ставить Node. Понадобятся Docker Desktop или Docker Engine с Docker Compose v2 и место на диске под образы и журналы (документация Docker).

git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

Переменная OPENCLAW_IMAGE берёт готовый образ из GitHub Container Registry. Без неё скрипт собирает образ локально, а для этого нужно не меньше 6 ГБ оперативной памяти. Зеркало на Docker Hub называется openclaw/openclaw; неофициальные зеркала документация использовать не советует. На хосте без доступа в интернет образ сначала загружают командой docker load -i, а скрипт запускают с флагом --offline: он проверит, что образ уже есть локально, и не станет ничего скачивать.

Скрипт сам проводит первоначальную настройку: спрашивает API-ключи провайдера, создаёт токен Gateway, записывает его в файл .env и запускает Gateway через Docker Compose. Откройте http://127.0.0.1:18789/ и вставьте токен из .env в настройках (Settings). Ссылку на панель можно получить снова:

docker compose run --rm openclaw-cli dashboard --no-open

Каналы подключаются через тот же служебный контейнер, например Telegram:

docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>"

Для обновления скачайте новый образ и пересоздайте контейнер Gateway:

docker compose pull openclaw-gateway openclaw-cli
docker compose up -d openclaw-gateway

Не запускайте setup.sh повторно только ради смены образа: он перезаписывает .env из переменных текущей оболочки и значений по умолчанию. Команды docker compose выполняйте из корня репозитория. На VPS с публичным адресом перед запуском изучите раздел Security hardening, особенно цепочку брандмауэра DOCKER-USER.

npm, pnpm или bun: если Node уже установлен

Этот путь для тех, кто сам управляет Node.js. Сначала проверьте версии: node --version должен показать 24.16+ или 26.1+, а от вывода npm --version зависит нужный флаг.

# npm 12 или npm 11.16+
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 12 по умолчанию блокирует скрипты установки пакетов, и флаг --allow-scripts=openclaw разрешает шаги preinstall и postinstall OpenClaw. В npm 11.15 и более ранних версиях такого флага нет — запускайте ту же команду без него. Скрипт установки подбирает флаг под вашу версию npm сам.

# pnpm
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

Команда pnpm approve-builds -g для глобальной установки не поддерживается, поэтому разрешение передаётся флагом --allow-build. Для bun команда установки — bun add -g --trust openclaw@latest; основной средой выполнения остаётся Node, а запуск Gateway под Bun 1.4+ описан на странице установки.

Флаг --install-daemon сразу ставит Gateway фоновой службой, так что отдельный openclaw gateway install здесь не нужен.

Ещё два варианта. Скрипт curl -fsSL https://openclaw.ai/install-cli.sh | bash кладёт Node и OpenClaw в ~/.openclaw, не требует root и не меняет остальную систему; команда окажется в ~/.openclaw/bin, а мастер настройки по умолчанию не запускается — выполните openclaw onboard сами. Сборка из исходного кода нужна тем, кто правит сам OpenClaw: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git клонирует репозиторий и собирает его через pnpm.

Как проверить, что OpenClaw работает

openclaw --version        # CLI установлен и доступен
openclaw doctor           # нет ли проблем в конфигурации
openclaw gateway status   # Gateway запущен
openclaw dashboard        # открыть панель управления

Установка в порядке, если:

• openclaw --version печатает номер версии;
• openclaw doctor не сообщает о проблемах конфигурации;
• openclaw gateway status показывает, что Gateway слушает порт 18789 (в Windows — openclaw gateway status --json);
• панель управления (Control UI) открывается, а на первое сообщение в её чате приходит ответ модели.

Если что-то не сходится:

• command not found для openclaw почти всегда значит, что каталог глобальных пакетов npm не попал в PATH. Проверьте node -v, npm prefix -g и echo "$PATH".
• openclaw triage выполняет проверки только на чтение и составляет описание проблемы. С машины ничего не уходит, пока вы сами не выберете агента для разбора; прочитать результаты можно и через openclaw doctor.
• Если на Linux npm отвечает EACCES, глобальный префикс npm принадлежит root. Скрипт установки умеет переключить его на ~/.npm-global и дописать PATH в файлы оболочки.
• Если установка подолгу стоит на загрузке, учтите: скрипт ждёт каждое зависшее соединение до пяти минут. Скачивает он сам установщик с openclaw.ai, пакет из реестра npm и Node через Homebrew или репозиторий NodeSource. Если сеть блокирует или замедляет HTTPS-доступ к GitHub и не проходит git clone, документация советует другую сеть, VPN или HTTP(S)-прокси.
• Gateway запущен, но порт не отвечает — см. OpenClaw порт не прослушивается; коды ошибок разобраны на странице Центр устранения ошибок OpenClaw.

Если раньше стоял Clawdbot или Moltbot

Clawdbot и Moltbot — прежние названия OpenClaw, но на npm это отдельные пакеты, которые не обновлялись с января 2026 года. Состояние реестра npm на 24 сентября 2026 года:

Пометки об устаревании у старых пакетов нет, поэтому npm не предупредит, что ставит старую сборку. Проверить версии можно самостоятельно: npm view clawdbot version и npm view openclaw version.

Как перейти на OpenClaw:

1. Посмотрите, что установлено: npm ls -g --depth=0.
2. Удалите старые пакеты: npm rm -g clawdbot и npm rm -g moltbot, если он тоже есть.
3. Установите OpenClaw пока без мастера настройки: на macOS и Linux — curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard, в Windows — вариант с -NoOnboard из раздела о PowerShell.
4. Только для Linux: выполните openclaw gateway uninstall. От старых установок может остаться служба clawdbot-gateway.service, и эта команда находит и удаляет её автоматически (документация по удалению).
5. Пройдите настройку и поставьте новую службу: openclaw onboard --install-daemon.
6. Проверьте результат командами из раздела о проверке.

Официального способа перенести настройки времён Clawdbot или Moltbot нет: руководство по миграции описывает только импорт из Claude Code, Claude Desktop и Hermes (openclaw migrate) и перенос уже установленного OpenClaw на другую машину (openclaw backup create). Рассчитывайте на то, что модель и каналы придётся подключить заново, и не удаляйте старые файлы настроек, пока новая установка не заработает. Если же на машине уже стоит OpenClaw, поставленный до июня 2026 года, его нужно не переустанавливать, а обновить через промежуточную версию — порядок описан в разделе об обновлении.

Если Clawdbot был развёрнут в Docker по старой инструкции, разверните OpenClaw заново из репозитория openclaw/openclaw по разделу о Docker: скрипт настройки там называется ./scripts/docker/setup.sh.

Как обновить OpenClaw

Обычно хватает одной команды:

openclaw update

Она сама определяет, как установлен OpenClaw (npm, pnpm, Bun или git), проверяет новую версию, пока работает прежний Gateway, и переключается на неё. Установка в Docker обновляется заменой образа — команды есть в разделе о Docker. Перед крупным обновлением документация советует сделать проверенную резервную копию.

Если OpenClaw установлен до июня 2026 года

Такую установку нельзя сразу обновлять до последней версии. Сначала нужна промежуточная версия 2026.9.5: она переносит старые базы задач, потоков и состояния плагинов и исправляет устаревшие ключи в конфигурации агентов. Если последняя версия уже поставлена поверх старой, openclaw doctor остановится, не переписывая такую конфигурацию, и предложит пройти тот же путь через 2026.9.5.

Для установки через npm со службой Gateway порядок такой. Все команды выполняйте под тем же пользователем и с тем же профилем, на Node 24.16+ или 26.1+:

# резервная копия состояния
openclaw gateway stop
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify

# шаг 1: промежуточная версия и её миграции
npm install -g openclaw@2026.9.5 --allow-scripts=openclaw && openclaw --version && openclaw doctor --fix

Убедитесь, что openclaw --version показал 2026.9.5, а openclaw doctor --fix перенёс старые данные без ошибок и конфликтов. Только после этого ставьте актуальную версию:

# шаг 2: последняя версия
npm install -g openclaw@latest --allow-scripts=openclaw && openclaw doctor --fix && openclaw gateway start && openclaw gateway status --deep

В npm 11.15 и более ранних версиях уберите из команд флаг --allow-scripts=openclaw. Для pnpm замените установку на pnpm add -g --allow-build=openclaw openclaw@2026.9.5, а затем на тот же вариант с @latest; для Bun — bun add -g --trust openclaw@2026.9.5 и затем @latest. Если Gateway запущен вручную или своей службой, останавливайте и запускайте его тем же способом, а не командами openclaw gateway.

Частые вопросы

Подойдёт ли Node 22?

Нет. OpenClaw поддерживает Node 24.16+ и 26.1+, а Node 22, 23 и 25, как и Node 24 до 24.16 и Node 26 до 26.1, не поддерживаются. Проще всего поставить OpenClaw скриптом: он сам установит подходящую версию. Если CLI всё же запущен на неподдерживаемой Node, он может предложить поставить собственную среду выполнения (вопрос Update NodeJS: Y/N [N]:); системный Node при этом не меняется.

Сколько оперативной памяти нужно OpenClaw?

Для обычной установки минимальный объём памяти в документации не указан. Конкретные цифры есть в двух случаях: локальная сборка Docker-образа требует не меньше 6 ГБ (готовый образ ghcr.io/openclaw/openclaw:latest это требование снимает), а для Raspberry Pi указан минимум 1 ГБ. Если на небольшом VPS процессы завершаются с кодом 137, разбор нехватки памяти есть в разделе Memory pressure and OOM kills документации по Linux.

Можно ли поставить OpenClaw на Raspberry Pi?

Да, скрипт установки поддерживает Raspberry Pi OS, но только 64-битную: на 32-битном ARMv7 установка останавливается, потому что официальных сборок Node 24+ для этой архитектуры нет. Страница Raspberry Pi в документации называет минимум 1 ГБ оперативной памяти, одно ядро и 500 МБ свободного места, а рекомендует от 2 ГБ памяти, карту SD от 16 ГБ или USB SSD и подключение по Ethernet: Pi 4 или 5 с 2 ГБ и больше, лучше с 4 ГБ. Эти цифры относятся только к Raspberry Pi.

Как удалить OpenClaw?

Начните с openclaw uninstall: по умолчанию команда предлагает убрать только службу Gateway, а для полного удаления отметьте ещё состояние, рабочую папку и приложение или запустите openclaw uninstall --all. Посмотреть, что будет удалено, можно через openclaw uninstall --dry-run --all. Сам CLI после этого удаляется тем же менеджером пакетов, которым ставился, например npm rm -g openclaw (удаление).

Что настроить после установки

• Мессенджер. Быстрее всего подключается Telegram — нужен только токен бота: Настройка OpenClaw в Telegram. Discord, Slack, WhatsApp и другие каналы описаны в разделе Channels документации.
• Модель и другие параметры. Мастер настройки открывается снова командой openclaw configure; о моделях Kimi — OpenClaw и Kimi: настройка K3 после отключения K2.5.
• Ошибки ключей и лимитов — Ошибки API-ключей OpenClaw и лимиты запросов.
• Управление браузером — Руководство по OpenClaw Browser Relay.