Пошаговая установка OpenClaw — от пустой машины до бота в Telegram, который работает, пока вы спите. Терминал нужен один раз, чтобы поселить помощника. Дальше — только переписка.
На чём стоит этот чек-лист
Главный путь здесь — ставите не вы по бумажке, а Claude Code со скиллом-установщиком (режим A в разделе 03). Ваша работа — понимать, где решение принимаете вы, а где вы смотрите за работой агента. Документ стоит на трёх опорах:
docs.openclaw.ai и github.com/openclaw,
сверено 29.08.2026 описью «взято / не взято» по 17 источникам.Чего мы не мерили сами. По этому документу от начала до конца мы не проходили:
тайминги и цены взяты из источников, проверка «спустя ночь» не делалась.
Если что-то разошлось — прав первоисточник, а не эта страница: документация →
openclaw doctor --fix → чек-лист. Скиллы обновлялись 04.06.2026 под версию 2026.5.x,
а ветка ушла дальше — спорит скилл с документацией, прав документ. Так и скажите агенту.
Что-то пошло не так — напишите нам. Что сработало, что нет, на каком провайдере — из этих отчётов чек-лист дописывается. Пишите в чат своего потока интенсива.
Обычная переписка в Telegram. Разница с чатом нейросети в трёх вещах: он не забывает вас, он умеет делать, а не только отвечать, и он работает, пока вы спите.
Закрыли крышку — бот замолчал. Смысл всей затеи в том, что машина работает круглосуточно и будит себя сама по расписанию.
Сам OpenClaw бесплатный и пустой. Всё, что он умеет, — это подключённая модель, за которую вы платите, плюс скиллы, которые кто-то написал.
У бота есть терминал вашего сервера. Открытый бот = терминал у любого прохожего. Список допущенных — не настройка «на потом», а часть установки.
Расходов две строки, а не одна. И дорогая — вторая.
| Статья | Сколько |
|---|---|
| Сервер | от €4–5 до ~$12–24 в месяц — в зависимости от провайдера и размера |
| Модель по подписке | $20/мес (ChatGPT Plus, внутри Codex) — рекомендуемый старт |
| Модель по API без роутинга | $30–50 в сутки. Так делать не надо |
| Режим | Кому | Как |
|---|---|---|
| A. Ставит агент — основной путь | всем, у кого есть Claude Code | Поставить скиллы одной командой (ниже), включить Bypass permissions, дать команду. Человек делает руками только 4 вещи. 15–30 минут |
| B. Руками | кто хочет понимать, что происходит, или ставит туда, под что скилла нет | Шаги 1–9 ниже. Их же читает агент в режиме A, когда скилла под провайдера нет |
| C. Готовый образ | только DigitalOcean | В маркетплейсе есть официальный 1-Click образ OpenClaw с мастером при первом входе |
Пять готовых скиллов от CodeAlive-AI: три под конкретных провайдеров и два общих. Ставятся в терминале до начала работы.
# выберите ОДИН из трёх — под своего провайдера npx skills add CodeAlive-AI/ceo-ai-os@install-openclaw-to-digitalocean -g -a claude-code -y npx skills add CodeAlive-AI/ceo-ai-os@install-openclaw-to-hetzner -g -a claude-code -y npx skills add CodeAlive-AI/ceo-ai-os@install-openclaw-to-yc -g -a claude-code -y # эти два — всегда, независимо от провайдера npx skills add CodeAlive-AI/ceo-ai-os@openclaw-guide -g -a claude-code -y npx skills add CodeAlive-AI/ceo-ai-os@openclaw-user-onboarding -g -a claude-code -y
| Скилл | Что делает |
|---|---|
install-openclaw-to-… | Ведёт агента от пустого аккаунта до ответа бота в Telegram: машина, первоначальная настройка, файрвол, установка, модель, Telegram, проверка |
openclaw-guide | Справочник по эксплуатации: каналы, память, расписание, MCP, конфиг, типовые поломки. Нужен и во время установки — установщик смотрит в него, когда что-то пошло не так |
openclaw-user-onboarding | Последние две-три минуты: спрашивает, кто вы и как с вами разговаривать, и пишет это на сервер. Без него бот отвечает обезличенно |
-g -a claude-code обязательны. Без них скиллы уезжают в папку
.agents/skills/, которую Claude Code не читает: вы увидите бодрый отчёт об установке
при пустом результате. Проверка: папки со скиллами появились в ~/.claude/skills/.
После установки — перезапустить Claude Code.docs.openclaw.ai — прав документ. Скажите это агенту прямо.
bot.Скопируйте целиком и вставьте в новую сессию Claude Code. Промпт удерживает агента в рамках: короткие шаги, остановки на том, что делает человек, запрет выдумывать результат.
Поставь мне OpenClaw на сервер. Я не разработчик, объясняй простыми словами. Как работаем: — Короткими шагами. После каждого шага одной строкой: что сделал и как проверил, что это сработало. — Ничего не выдумывай. Команда не отработала — покажи ошибку целиком и скажи, что делаешь дальше. — Секреты (токены, ключи, пароли) не пиши в чат и не клади в файлы, которые уходят в git. — Перед любой командой, которая что-то удаляет или переписывает, — спроси меня. Есть четыре вещи, которые могу сделать только я. Дойдя до каждой — ОСТАНОВИСЬ и объясни, что нажимать: 1. Зарегистрироваться у хостинг-провайдера и привязать карту. 2. Создать телеграм-бота у @BotFather и передать тебе токен. 3. Включить авторизацию по коду устройства, если модель подключается по подписке. 4. Написать боту первое сообщение и подтвердить сопряжение. Порядок работы: 1. Спроси, есть ли у меня сервер. Если нет — предложи два варианта, объясни выбор одной фразой и помоги заказать. 2. Подготовь систему: обновления, отдельный пользователь вместо root, вход по ключу, файрвол. Объясни, зачем отдельный пользователь. 3. Установи OpenClaw актуальным способом с официального сайта и покажи мне, что он запустился. 4. Подключи модель и проверь обычной перепиской, что она отвечает осмысленно. Пока не отвечает — дальше не идём ни при каких условиях. 5. Подключи телеграм и закрой доступ списком разрешённых, где только мой ID. 6. Пропиши как службу с автозапуском и проверь перезагрузкой сервера, что поднялся сам. 7. В конце дай мне короткую памятку: где что лежит, как посмотреть логи, как остановить, как удалить всё целиком. Начни с первого вопроса.
Пять поведенческих граблей, собранных на живой установке — у каждой есть готовая фраза-лечение. Это не придирки к модели, а рабочий приём: агент сильнее всего там, где ему задан вектор.
| Что вы видите | Что происходит | Что сказать |
|---|---|---|
| Уверенно заявляет, что чего-то не существует или недоступно | Ответил из памяти, не сходив в интернет. Знания модели отстают на месяцы | «Перепроверь эту информацию в интернете» |
| Упёрся в ошибку и ходит по кругу | Не ищет обходной путь сам — ждёт разрешения сменить подход | «Поищи альтернативу. Мысли шире» |
| Отчитался «готово», а на деле не работает | Создал и не проверил. Проверку надо требовать явно | «Проверь, что это реально работает, и покажи вывод» |
| Просили «с нуля», а он собрал из старого | Подтянул уже установленные скиллы и выдал их результат за новый | «Не используй существующие скиллы» |
| Сделал проще, чем просили | Срезал угол: цель была, а вектора не было | Назвать признак готовности: «готово = бот ответил мне в Telegram» |
Провайдер-специфичен только шаг 1. Всё дальше одинаково на любом хостинге.
| Что | Минимум | Рекомендуем | Почему |
|---|---|---|---|
| Процессор | 2 ядра | 2–4 ядра | тяжёлое считает модель на своей стороне, машина «дирижирует» |
| Память | 2 ГБ | 4 ГБ | 2 ГБ хватает для чата; на браузерные автоматизации ведущему воркшопа «не всегда хватало» |
| Диск | 20 ГБ | 40 ГБ | переписка, логи, скачанные файлы |
| Система | Ubuntu 22.04 / 24.04 LTS | под неё написаны все установочные скрипты | |
Три провайдера, под которых есть готовый скилл-установщик — равноценны, выбирайте по тому, где вам удобнее платить.
| Провайдер | Цена входа | Скилл | Что учесть |
|---|---|---|---|
| DigitalOcean | $4–6 базовый, ~$12 за 2 ГБ | …-to-digitalocean | лучшая документация; есть 1-Click образ; файрвол — отдельная сущность провайдера. Выключенная машина всё равно биллится — гасит только удаление |
| Hetzner | €4–5 (2 vCPU / 4 ГБ / 40 ГБ) | …-to-hetzner | лучшая цена за мощность (ARM); файрвол по умолчанию закрыт на вход; строгая проверка при регистрации |
| Yandex Cloud | в тенге, порядок тот же | …-to-yc | казахстанская зона и оплата в тенге; скилл привязан к зоне kz1-a. Мы ушли — выше счёт при том же железе; но скилл рабочий |
Остальные — скилла нет, но это не запрет.
| Провайдер | Цена входа | Что учесть |
|---|---|---|
| Timeweb Cloud | ~300–600 ₽/мес | наш текущий; дружелюбная панель, есть зарубежные локации |
| Contabo · Vultr · RuVDS · Aeza · Selectel | от €5,50 · $6 · 139 ₽ · почасовая · с SLA | Contabo — больше всего памяти за деньги, слабее диск и поддержка; Selectel — корпоративный с SLA |
Единственное место, где расходятся три установочных мастера:
| Yandex Cloud | DigitalOcean | Hetzner | |
|---|---|---|---|
| Командная утилита | yc | doctl | API-токен |
| SSH-ключ | передаётся при создании | сначала загрузить в аккаунт, иначе создание не примет | передаётся при создании |
| Файрвол провайдера | группа безопасности | отдельный ресурс, действует только после привязки к машине | firewall Hetzner |
| Регион по умолчанию | Караганда | Франкфурт, запасной Амстердам | Фалькенштайн |
| Пауза ради экономии | есть, дёшево | не существует — платить перестаёт только удаление | есть |
sudo apt update && sudo apt upgrade -y
sudo apt install curl git ca-certificates -yОтдельный пользователь — не опция, а требование. У бота есть терминал: под администратором любая его ошибка или чужое сообщение может снести систему.
sudo adduser openclaw
sudo usermod -aG sudo openclaw
sudo -iu openclawБазовая защита:
sudo ufw --force reset
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw --force enable
sudo systemctl enable --now fail2ban
sudo systemctl enable --now unattended-upgradesПлюс вход по ключу вместо пароля. Проверять конфиг до перезагрузки sshd —
sudo sshd -t, иначе можно закрыть себе вход навсегда.
Два официальных пути. Первый предпочтителен — он сам ставит нужную версию Node и запускает мастер настройки.
curl -fsSL https://openclaw.ai/install.sh | bashЧерез npm, если Node уже нужной версии:
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw --version--allow-scripts=openclaw обязателен на npm 12 и 11.16+. Без него пакет
встанет без установочных скриптов и шлюз молча не заведётся. На npm 11.15 и старше флаг,
наоборот, надо убрать. Проверить: npm --version.
Node нужен 26 (либо 22.22.3+, 24.15+, 25.9+).
Первичная настройка — интерактивно (установщик запускает мастер сам):
openclaw onboardСразу вместе со службой:
openclaw onboard --install-daemonНеинтерактивно, для скриптов — только эта пара флагов:
openclaw onboard --non-interactive --accept-risk--no-prompt — молчаливая пустышка: неизвестный флаг проглатывается, команда
«отрабатывает», ничего не сделав. Ловушка задокументирована по итогам реального прогона.
1. Подписка Codex — рекомендуемый старт. ChatGPT Plus $20/мес.
openclaw models auth login --provider openai-codex --device-code
openclaw models list2. OpenRouter — один ключ ко многим моделям, работает с российских адресов:
export OPENROUTER_API_KEY='sk-or-...'
openclaw config set agents.defaults.model.primary 'openrouter/<провайдер>/<модель>'
openclaw config set agents.defaults.model.fallbacks '["openrouter/anthropic/claude-haiku-4-5"]'3. Прямой ключ Anthropic:
openclaw config set agents.defaults.model.primary 'anthropic/claude-sonnet-4-6'
openclaw config set agents.defaults.model.fallbacks '["anthropic/claude-haiku-4-5"]'/model бесполезна — добавьте вторую./newbot → имя → username, обязательно заканчивается на bot → токен.openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "<токен>"
openclaw config set channels.telegram.dmPolicy "pairing"dmPolicy: pairing — и есть тот самый замок. Бот отвечает только тем, кто прошёл
сопряжение: присылает код, вы подтверждаете. Шлюз при этом слушает только локальный адрес и наружу
не публикуется.
Проверка: написать боту «Привет! Ты кто и что умеешь?» — он должен ответить.
Здесь известное расхождение между источниками, и оно осознанное.
| Вариант | Кто так делает | Плюсы | Минусы |
|---|---|---|---|
| Системная служба | три установочных мастера | стартует при загрузке без сессии; применяется песочница systemd | требует прав администратора |
| Пользовательская + lingering | наши серверы | не нужен root, у каждого пользователя свой бот | нужна живая пользовательская сессия; песочница не применяется |
openclaw doctor --fix умеет поставить конкурирующую
пользовательскую службу рядом с системной. Если у вас системная — заранее выставьте политику
ремонта «внешняя», иначе после первого же doctor --fix получите два шлюза с одним
токеном и конфликт в логах.
systemctl --user status openclaw-gateway.service
systemctl --user restart openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -n 100 --no-pager
loginctl enable-linger $USERПроверка боем: перезагрузить машину и написать боту. Ответил — служба поднимается сама.
Скилл — инструкция «как делать вот такую задачу», читается только когда задача подвернулась. Формат общий: скиллы одинаковы для Claude Code, OpenClaw и Codex — это стандарт.
Обязательный к установке — openclaw-guide: справочник по эксплуатации, 9 разделов,
11 критичных граблей.
/btw) скилл не ставится — только из основной сессии.Ставятся сообщением боту — «каждый будний день в 9 утра присылай сводку».
Механика, которую надо понимать: шлюз проверяет список задач раз в минуту, и каждая задача выполняется в чистой сессии, без истории. Значит формулировать надо самодостаточно — «пришли сводку как вчера» не сработает.
Отдельно про heartbeat — когда агент периодически просыпается сам. Он расходует токены просто по факту существования. Включать осознанно и считать расход.
| Команда | Когда нужна |
|---|---|
openclaw --version | проверить, что стоит |
openclaw doctor --fix | непонятная поломка. Удаляет файл профилей авторизации — потребуется войти заново |
openclaw models list | какие модели реально доступны |
openclaw config get agents.defaults.model | текущая модель |
| резервная копия | делать до обновления, не после |
| проверка расхода | иначе счёт становится сюрпризом |
| Симптом | Причина и действие |
|---|---|
| Бот молчит | Статус службы → логи шлюза. Служба жива, а ответа нет — смотреть авторизацию |
| Отвечал, замолчал через полдня | Telegram-адаптер умирает примерно через 12 часов. Проверять живучесть спустя ночь, а не сразу после установки |
| Задача «отработала», ничего не пришло | Изолированная задача не доставляет в Telegram |
| Конфликт в логах Telegram | Два процесса с одним токеном. Найти все машины и сессии, оставить один |
| «Все модели отказали» | Чаще всего это не модель, а авторизация: дубль профиля или два пользователя на одной подписке |
| Запасная модель «уперлась в лимит» | Проверить не лимит, а баланс — у нас запасная умерла от кончившихся кредитов, а сообщение врало про лимит |
| Команда не найдена после установки | Перезайти по SSH или перечитать окружение |
/model ничего не переключает | В конфиге одна модель — добавить вторую |
| Пропали слэш-команды | Много скиллов вытеснили их |
| Бот выдумывает, качество упало | Контекст переполнен — сжать сессию, ограничить окно |
| Сообщения копятся, ответа нет | Шлюз не параллелен, ставит сообщения в очередь |
| SSH не пускает, машина «активна» | fail2ban забанил агента за частые подключения. Вход — через веб-консоль провайдера, потом править лимиты |
| Установка упала на первоначальной настройке машины | В скрипт попало длинное тире или другой не-ASCII символ — реальный случай с воркшопа. Попросить агента проверить скрипт на чистоту ASCII |
| Вход по подписке Codex не проходит | OpenAI по умолчанию запрещает вход стороннего приложения. ChatGPT → Settings → Security → включить авторизацию кода устройства |
| Новый аккаунт у провайдера притормозили | Антифрод: много действий сразу после регистрации выглядит подозрительно и может дать бан на полчаса. Подождать и продолжить |
| Агент бросил работу в браузере на полпути | Закрыли вкладку, в которой он работал. Переключаться между вкладками можно, закрывать рабочую — нет |
| Правда о падении не видна в логах службы | Смотреть логи сессий агента, а не системный журнал |
GUIDE.mdINSTALL-HERMES.mdUSE-CASES.mdOPENCLAW-VS-HERMES.mdOUR-EXPERIENCE.mdprojects/education/AI-Camp/WORKSHOP-openclaw-digitalocean.mdprojects/education/AI-Camp/skills/openclaw-install/