Как установить OpenClaw: команды, onboarding и проверка запуска

Короткий ответ

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

macOS, Linux или WSL2:

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

Windows PowerShell:

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

Установщик определяет ОС, при необходимости устанавливает Node.js, устанавливает OpenClaw и запускает onboarding. После настройки проверьте CLI, Gateway и dashboard. Если вы хотите сначала только установить CLI без onboarding, используйте соответствующий флаг --no-onboard, описанный в официальной инструкции.

Требования

Официальная документация указывает Node.js 24.16+ или 26.1+; Node 26 рекомендуется. Поддерживаются macOS, Linux и Windows. Для Windows доступны нативный Windows Hub, PowerShell CLI и WSL2 Gateway.

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

node --version

Если Node.js ещё не установлен, основной установщик может подготовить его. Если вы управляете Node.js самостоятельно, используйте пакетный способ установки. Перед изменениями подготовьте резервную копию важных конфигураций и убедитесь, что запускаете команду в правильной оболочке: Bash и PowerShell используют разный синтаксис.

Установка через npm или pnpm

Если Node.js уже настроен, можно установить CLI через npm:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Эта команда с --allow-scripts=openclaw предназначена для npm 12 и npm 11.16+. Для npm 11.15 и более ранних версий документация указывает вариант без этого флага.

Для pnpm:

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

pnpm требует явно разрешить сборочные скрипты. Не смешивайте несколько способов установки до завершения диагностики: зафиксируйте выбранный метод и версию.

Onboarding и фоновый Gateway

После запуска установочного скрипта onboarding обычно открывается автоматически. Выберите Quick start, если доступ к модели уже найден, или Custom setup для пошаговой настройки. Для полноценного чата понадобится существующий вход Claude Code или Codex CLI либо API-ключ провайдера.

Если Gateway пока работает в текущем терминале, остановите foreground-процесс сочетанием Ctrl+C, затем установите фоновый сервис:

openclaw gateway install

Для пакетной установки onboarding можно запустить отдельно:

openclaw onboard --install-daemon

Тип сервиса зависит от среды: LaunchAgent на macOS, systemd user unit на Linux и WSL2, Scheduled Task на нативной Windows с описанным резервным вариантом через папку автозапуска.

Проверка результата

Выполните базовые проверки:

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

Успешный результат означает, что CLI доступен, диагностика показывает состояние конфигурации без критической проблемы, Gateway работает, а dashboard открывается в браузере. Затем отправьте одно контролируемое сообщение в Control UI и проверьте получение ответа.

Проверка dashboard подтверждает доступность интерфейса, но не доказывает, что каждый канал или бизнес-сценарий настроен. Подключайте Telegram, Discord, Slack, WhatsApp и другие каналы отдельно и проверяйте их собственными тестами.

Если команда openclaw не найдена

Сначала проверьте наличие Node.js и расположение глобальных пакетов:

node -v
npm prefix -g
echo "$PATH"

Типичная причина — каталог глобальных исполняемых файлов npm не входит в PATH текущей оболочки. На Windows проверьте PATH в PowerShell и перезапустите оболочку после изменения окружения. Если вы устанавливали OpenClaw из исходников и pnpm сообщает, что глобальный bin-каталог отсутствует в PATH, документация предлагает выполнить pnpm setup, открыть новую оболочку и повторить установку.

Если проблема не связана с PATH, выполните:

openclaw doctor
openclaw triage

doctor предназначен для проверки конфигурации, а triage — для read-only диагностики текущего состояния и подготовки описания найденных проблем. Не публикуйте токены и секреты в выводе команд или обращениях за помощью.

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

Установленный OpenClaw ещё не является готовой автоматизацией бизнеса. После базовой проверки отдельно настройте выбранный канал, модель, инструменты и права. Начните с одного контролируемого сценария и тестовых данных. Для действий с последствиями — отправки сообщений, изменения записей или запуска команд — заранее определите ручное подтверждение.

Рекомендуем перед подключением рабочих данных проверить доступы, подготовить резервную копию конфигурации и убедиться в результате на тестовом примере. Подключение CRM, почты, 1С или внутреннего API требует отдельной проверки конкретной системы и не следует автоматически из факта установки OpenClaw.

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