OpenClaw удобен ровно до момента, когда Gateway не стартует после выхода из системы или Windows внезапно «не видит» команду openclaw. Ниже пошаговая установка под три ОС с нюансами, из-за которых обычно и горит. Основу взял из официальных доков и репозитория OpenClaw. Install, GitHub.
Перед стартом, что нужно всем
OpenClaw рассчитывает на современный Node.js. Проверьте версии.
node -v
npm -vДальше везде логика одинаковая. Ставим CLI, запускаем мастер, ставим Gateway как фоновую службу, проверяем статус.
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboardФлаг install-daemon критичен. Он настраивает автозапуск Gateway через системный механизм ОС.
macOS
1) Установка
curl -fsSL https://openclaw.ai/install.sh | bash2) Онбординг и автозапуск
openclaw onboard --install-daemonНа macOS мастер ставит LaunchAgent. Нюанс: LaunchAgent стартует в пользовательской сессии. Если Mac работает без логина пользователя, Gateway сам не поднимется, придется делать отдельное решение для серверного режима.
3) Проверка
openclaw gateway status
openclaw dashboardLinux
1) Установка
curl -fsSL https://openclaw.ai/install.sh | bash2) Онбординг и systemd user unit
openclaw onboard --install-daemonНа Linux мастер ставит systemd user unit. Чтобы Gateway жил после выхода из сессии, часто нужен lingering. Мастер обычно пытается включить lingering сам, иногда попросит sudo.
3) Проверка и управление
openclaw gateway status
openclaw gateway restart
openclaw gateway stopWindows
Для Windows официальная стабильная схема идет через WSL2, то есть OpenClaw работает внутри Linux-окружения. Установка и запуск делаются в терминале Ubuntu (WSL), а не в обычном PowerShell.
Вариант A. Рекомендуемый, WSL2 + Ubuntu
Шаг 1. Поставьте WSL2 и Ubuntu. Запустите PowerShell от администратора.
wsl --install -d UbuntuШаг 2. Включите systemd в WSL. Без systemd Gateway не станет нормальной службой.
sudo nano /etc/wsl.conf[boot]
systemd=trueЗатем закройте WSL и перезапустите.
exitВ PowerShell.
wsl --shutdownОткройте Ubuntu снова и проверьте, что PID 1 это systemd.
ps -p 1 -o comm=Шаг 3. Установите OpenClaw внутри Ubuntu (WSL).
curl -fsSL https://openclaw.ai/install.sh | bashШаг 4. Онбординг и служба Gateway.
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboardОбновление
Самый надежный способ обновиться: снова запустить установочный скрипт, он обновит CLI и не сломает окружение.
curl -fsSL https://openclaw.ai/install.sh | bashВозможные ошибки и как исправить
Команда openclaw не находится
Проверьте, где ставили OpenClaw. Если установка шла в WSL, запускайте openclaw в терминале Ubuntu (WSL), а не в PowerShell. На macOS и Linux проверьте, что npm global bin в PATH.
npm config get prefix
npm bin -gNode.js слишком старый
OpenClaw требует современный Node. Обновите Node до актуальной версии, затем переустановите OpenClaw.
node -v
npm rm -g openclaw
npm install -g openclaw@latestGateway работает только пока открыт терминал
Службу не поставили или установка демона не завершилась. Запустите онбординг с установкой демона.
openclaw onboard --install-daemon
openclaw gateway statusLinux, после выхода из сессии Gateway пропадает
Включите lingering для пользователя, чтобы systemd user unit продолжал жить без активной сессии.
loginctl show-user $USER | grep Linger
sudo loginctl enable-linger $USERWSL2, Gateway не ставится как служба
Почти всегда выключен systemd в WSL. Включите systemd в /etc/wsl.conf и перезапустите WSL через wsl --shutdown.
ps -p 1 -o comm=
wsl.exe --shutdownmacOS, Gateway не стартует после перезагрузки
LaunchAgent стартует только в пользовательской сессии. Войдите в учетку и проверьте статус. Если нужен серверный режим без логина, LaunchAgent не подходит, потребуется отдельная настройка автозапуска на уровне системы.
openclaw gateway statusПосле обновления что-то сломалось
Откатите CLI на конкретную версию из релизов, затем перезапустите Gateway.
npm install -g openclaw@X.Y.Z
openclaw gateway restartopenclaw gateway status показывает ошибку, но конфиг уже есть
Прогоните диагностику и попробуйте мягкий рестарт. Часто хватает починки служб и окружения.
openclaw doctor
openclaw gateway restartАгент не видит утилиты, которые доступны в терминале
Служба Gateway может запускаться с другим PATH. Добавьте утилиты в стандартные системные пути или настройте окружение службы. Для быстрой проверки вызовите exec и посмотрите, какой PATH видит агент.
echo $PATH
