Как запустить у себя OpenClaw полный гайд

OpenClaw - это персональный AI-ассистент, который ты запускаешь на своих устройствах. Он работает через Gateway, умеет подключаться к разным каналам вроде Telegram, WhatsApp, Discord и другим, а основной рекомендованный путь установки сейчас - через CLI с последующим запуском onboarding.

Перед установкой подготовь три вещи:

Проверить Node можно так:

node--versionnpm--version

Если Node не установлен, официальный установщик OpenClaw умеет сам попытаться его поставить. Это прямо указано в install-документации.

🚀В моем Max - больше самых невероятных инструментов и ИИ- туториалов .

Если у тебя macOS или Linux - ставить проще всего нативно.Если у тебя Windows - OpenClaw поддерживается и нативно, и через WSL2, но в документации отдельно отмечено, что WSL2 стабильнее и рекомендуется для полного опыта.

Поэтому практический совет такой:

Официальная документация рекомендует установщик-скрипт. Он определяет ОС, ставит Node при необходимости, ставит OpenClaw и запускает onboarding. Для macOS, Linux и WSL2 используется shell-скрипт, для Windows - PowerShell-скрипт.

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

iwr-usebhttps://openclaw.ai/install.ps1|iex

Если ты хочешь сначала только поставить OpenClaw без запуска onboarding, в документации есть вариант --no-onboard:

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

Если не любишь пайпить shell-скрипты в bash, можно поставить OpenClaw вручную. В GitHub README как рекомендованный вариант указаны npm install -g openclaw@latest или pnpm add -g openclaw@latest, после чего запускается onboarding с опцией установки daemon-сервиса.

npm install -g openclaw@latest

pnpm add -g openclaw@latest

После установки запускай:

openclaw onboard --install-daemon

Согласно README, эта команда запускает пошаговую настройку и ставит Gateway daemon как user-service через launchd или systemd, чтобы OpenClaw продолжал работать в фоне.

Onboarding - это главный стартовый мастер настройки. Официальная документация рекомендует начинать именно с него: он помогает поднять gateway, настроить workspace, подключить каналы и skills. В docs прямо сказано, что после него у тебя должен быть рабочий Gateway, настроенная авторизация и рабочая сессия чата.

Во время onboarding OpenClaw обычно просит:

Если ты ставил через onboarding, то дальше можно проверить, что всё живо. В README как quick start показаны команды запуска gateway, отправки сообщения и обращения к агенту.

openclaw gateway --port18789--verbose

В setup-документации для проверки рекомендуют:

openclaw health

Если всё поднялось нормально, health-check должен показать, что gateway доступен.

В quick start из README есть такой пример:

openclaw message send --to+1234567890--message"Hello from OpenClaw"

А если хочешь просто обратиться к агенту напрямую:

openclaw agent --message"Ship checklist"--thinking high

Это уже базовая проверка того, что OpenClaw не просто установлен, а реально отвечает через агентный слой.

OpenClaw позиционируется как gateway для AI-агентов через разные каналы. В docs и README перечислены Telegram, WhatsApp, Discord, Slack, Signal, Teams, Matrix и другие платформы. Для привязки каналов в setup-документации показана команда openclaw channels login.

Запусти:

openclaw channels login

После этого OpenClaw проведёт тебя по flow авторизации нужного канала. На macOS в стабильном варианте setup docs рекомендуют такой порядок: установить приложение, пройти permissions checklist, убедиться что gateway local и запущен, потом линковать каналы через openclaw channels login, а затем сделать openclaw health.

В документации setup отдельно сказано, что пользовательская конфигурация и рабочее пространство хранятся вне репозитория, чтобы обновления не ломали кастомизацию. Основные пути:

Для первичной инициализации используется:

openclaw setup

Это полезно, если ты хочешь осознанно посмотреть, где лежат конфиги, и потом бэкапить workspace отдельно.

В README указано, что для обновлений есть updating guide и команда openclaw doctor. Также поддерживаются каналы stable, beta и dev. Переключение канала делается через openclaw update --channel stable|beta|dev.

Практически это выглядит так:

openclaw doctoropenclaw update --channel stable

Если тебе нужна максимальная стабильность, держись stable.Если хочешь свежие фичи и не боишься багов - beta или dev.

Официальные docs описывают и dev-путь: pnpm install, затем pnpm gateway:watch, после чего macOS app может подключиться в local mode к уже запущенному gateway. Это вариант для тех, кто хочет ковырять сам TypeScript Gateway, а не просто пользоваться готовой установкой.

Базовый flow из исходников:

pnpm installpnpm gateway:watch

И потом проверка:

openclaw health

Но для обычного пользователя это не лучший старт. Для первого знакомства удобнее npm + onboarding.

Хотя в этой статье цель - установка, важный момент: сам проект и документация подчёркивают, что OpenClaw работает с токенами, allowlists и safety controls, а в README отдельно есть примечание, что для снижения риска prompt injection лучше использовать сильные современные модели. Одновременно в последние дни появились предупреждения о поддельных загрузках OpenClaw, через которые распространяют инфостилеры.

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

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

Этот сценарий полностью укладывается в текущий рекомендованный поток из официального README и getting started docs.

Самые частые причины обычно такие:

Проверь по порядку:

node--versionopenclaw --helpopenclaw health

Если ставил раньше и обновлялся, прогоняй:

openclaw doctor

А если нужна максимально чистая и предсказуемая установка - проще удалить глобальный пакет, убедиться в нормальном Node 24 и пройти весь onboarding заново. Официальные docs отдельно отсылают к troubleshooting и help-секции.

Если не усложнять, OpenClaw сейчас ставится довольно прямолинейно:

Если хочешь, я следующим сообщением соберу тебе уже готовую версию этой статьи в формате поста для Telegram - аккуратно оформленную и без лишней воды.