2026 OpenClaw официальный путь: openclaw onboard насквозь—Node 24, рабочая область, первый канал, ClawHub Skill, демон и обновления каналов

~14 мин чтения · MACCOME

Аудитория: вы поставили npm i -g openclaw по разрозненным заметкам, но скачете между workspace, Gateway, каналами и Skills, не проходя рекомендованный апстримом порядок openclaw onboard, и сомневаетесь, как вместе менять Node 24, демоны, каналы stable/beta/dev. Результат: проверяемый runbook—doctor → onboard → проверка первого канала → первый ClawHub Skill → установка демона → задокументированные обновления/откаты—чтобы вместо «как-то стартует» было «стабильно крутится без присмотра». Карта: шесть ловушек → таблица путей → шесть шагов → три поля для аудита; вместе с docker-setup + GHCR, Compose pairing 1008 и post-install doctor.

Почему «CLI установлен» ещё не «OpenClaw выкатан»

Апстрим рекомендует onboard, потому что у Gateway, workspace, каналов и дефолтов модели есть зависимости по порядку. Мастер в обход и правка JSON часто ведут к «процесс есть, сообщений нет» или «Skill поставлен, инструменты не регистрируются». Шесть частых неверных чтений в ветках 2026:

  1. Node «едва совместим»: ориентируйтесь на Node 24 (как минимум 22.16+). Ниже базы установка может пройти, а Gateway падает на нативных гранях.
  2. Пропустить openclaw doctor: риск застревания в конце onboard без бисекции; doctor — это шлюз, а не украшение.
  3. Skills до каналов: установка ок, в чате пусто; чаще без рестарта Gateway или незавершённый OAuth, а не «тупой моделью».
  4. Демон путают с интерактивной shell: крышка ноутбука останавливает Gateway, виноват «апстрим-версии».
  5. Недокументированный микс каналов: один на beta, другой на stable; дрейф CLI/Gateway даёт невоспроизводимые несоответствия.
  6. Эфемерные каталоги состояния: на удалённых Mac/VPS вынесенный диск делает обновления похожими на «потерю конфига».

Осознанно в контейнерах? Первично docker-setup + GHCR, эта статья вторична. Болтает subagent-pairing — читайте Compose 1008 до слепой переустановки npm.

Таблица: три входа (здесь основной—npm-onboard)

ПутьКомуЧто зафиксироватьСвязь с этой статьёй
openclaw onboard (npm global)выделенный Mac/VPS с долгим GatewayWorkspace, openclaw.json, unit launchd/systemd, факт по каналу, лог проверки SkillОсновной
Официальный Docker/Composeдоставка образами, единый рантаймCompose, карта томов, политика переключения OPENCLAW_IMAGEДополняет
Только triage с doctorуже установлено, но плоходеревья симптомов, отпечатки в логахПараллельное чтение
warning

Предупреждение: onboard пишет в home. На общих macOS-аккаунтах согласуйте политику. В проде выбирайте выделенные хосты или сервис-аккаунты.

Шестишаговый runbook: от пустого хоста к минимальной бездиспетчерской петле

  1. Node, версия на запись: закрепить nvm/оф. установщик; node -v в тикет.
  2. CLI + doctor: npm i -g openclaw@latest, потом openclaw doctor; снять риск до onboard.
  3. openclaw onboard: workspace, дефолтная модель, AGENTS.md, хотя бы один канал; порт Gateway и путь Control UI из вывода.
  4. Доказать канал: тестовое сообщение; при сбое triage с doctor, не крутить модель+канал разом.
  5. Первый ClawHub Skill: openclaw skills searchopenclaw skills install <name>рестарт Gatewayopenclaw skills list.
  6. Демон и пути логов: openclaw onboard --install-daemon (эквивалент в мастере); ротация и пороги диска до openclaw update --channel beta|dev.
bash
node -v
npm i -g openclaw@latest
openclaw doctor
openclaw onboard
openclaw skills search "calendar"
openclaw skills install example-org/some-skill
openclaw restart
openclaw skills list
openclaw onboard --install-daemon
openclaw update --channel stable

Три поля для change ticket

  1. Мажор Node + источник: напр. v24.x nvm; doctor после каждого апгрейда ОС.
  2. История listen/bind Gateway: loopback vs reverse-proxy/Tailscale, чтобы не конфликтовать с подсказками по Compose pairing.
  3. Сопоставление каналов: stable|beta|dev с календарными окнами; откаты—парой версий CLI+Gateway.

Это инженерные поля аудита, не SLA. Если рядом CI—алерты на CPU/диск, чтобы сборка не съедала логи/SQLite.

Архитектурно onboard якорит автоматизацию: фиксированы workspace/Skills, единая правда для бэкапов и обновлений. Без якоря—встречи «кто трогал openclaw.json».

Почему личный ноутбук слаб по умолчанию для 24/7 Gateway

Сон, всплески VPN, корп-политика ломают временную непрерывность Gateway. Когда OpenClaw—фактическая control plane, берите хост 24/7 с прогнозируемыми диском и исходом, ноут оставьте CLI-клиентом.

Домашние/офисные башни несут неконтролируемые окна патчей/питания. Для агентов рядом с iOS-фермой мультирегиональные Apple Silicon обычно дают чище SLO, чем одолженные ноуты. MACCOME — bare metal и гибкие сроки: тарифы и центр помощи по каналам и доступу.

Пилот: неделя onboard+демон на выделенном удалённом Mac, объём логов и пики CPU, затем решайте, садится ли beta на тот же хост; не привязывайте прод-Gateway с первой же недели к личной dev-машине.

Вопросы

В WSL2 тот же порядок, что на macOS?

Та же схема, другие пути/сеть—doctor + WSL2 triage вместо ожидания launchd-эквивалента.

Список skills пуст после установки—что в первую очередь?

Перезапуск Gateway, видимость workspace, затем triage no-reply, прежде чем бежать в beta-канал.

Конфликт с Docker-установкой?

Нет, но одну папку данных не делим; npm или контейнер—по политике. См. docker-setup + GHCR.