Как установить OpenClaw с нуля - пошагово - UPROGER

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

Что нужно заранее

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

Node.js – лучше Node 24, но поддерживается и Node 22.16+.
npm или pnpm.
API-ключ от провайдера моделей – например OpenAI, Anthropic или Google, потому что onboarding попросит настроить модель.

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

node --version
npm --version

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

На какой системе лучше ставить

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

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

macOS – ставь напрямую
Linux – ставь напрямую
Windows – лучше через WSL2

Самый быстрый способ установки

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

macOS / Linux / WSL2

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

Windows PowerShell

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

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

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

Более понятный и контролируемый способ – через npm

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

Через npm

npm install -g openclaw@latest

Через pnpm

pnpm add -g openclaw@latest

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

openclaw onboard --install-daemon

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

Что делает onboarding

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

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

выбрать или подтвердить модель
ввести API-ключ
создать локальную конфигурацию
поднять gateway
по желанию подключить каналы

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

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

Запуск gateway вручную

openclaw gateway --port 18789 --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 не просто установлен, а реально отвечает через агентный слой.

Как подключить Telegram, WhatsApp и другие каналы

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/openclaw.json – конфиг
~/.openclaw/workspace – workspace, skills, prompts, memories

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

openclaw setup

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

Как правильно обновлять OpenClaw

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

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

openclaw doctor
openclaw update --channel stable

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

Если хочешь ставить из исходников

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

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

pnpm install
pnpm gateway:watch

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

openclaw health

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

Минимально безопасная установка – как лучше делать сразу

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

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

скачивай только с официального GitHub и официального домена OpenClaw
не ищи установщик через рекламные объявления в поиске
для первого запуска используй отдельную тестовую среду
не подключай сразу основной Telegram, GitHub, почту и рабочие API-ключи
сначала проверь поведение на пустом workspace

Самая простая рабочая схема установки

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

macOS / Linux / WSL2

# 1. Проверить Node
node --version# 2. Поставить OpenClaw
npm install -g openclaw@latest# 3. Запустить onboarding
openclaw onboard --install-daemon# 4. Проверить здоровье
openclaw health# 5. Подключить каналы
openclaw channels login# 6. Если нужно - запустить gateway вручную
openclaw gateway --port 18789 --verbose

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

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

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

слишком старый Node
OpenClaw поставился, но gateway не поднялся
проблемы с каналом или авторизацией
на Windows используется нативный режим, а не WSL2, и из-за этого больше глюков

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

node --version
openclaw --help
openclaw health

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

openclaw doctor

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

Итог

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

ставишь Node 24
ставишь openclaw@latest
запускаешь openclaw onboard --install-daemon
проверяешь openclaw health
подключаешь каналы через openclaw channels login

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

Просмотры: 1 346