openclaw onboard --install-daemon, честный вывод openclaw gateway status (включая --deep, если это описано в ваших релиз-нотах к v2026.3.24) и веб-панель, где навыки ставятся почти в один клик, длинные ответы идут потоком, а откат не превращается в ручной копипаст. Официальный раздел onboard на docs.openclaw.ai дополняет картину интерактивного мастера и фонового сервиса. Связанные материалы без входа: Model Auth и логи шлюза, эмбеддинги и RAG на шлюзе.
Зачем фиксировать цикл письменно
Три типичных разрыва: SSH под своим пользователем, пока launchd крутит другой HOME и навыки оказываются «не там»; обновление CLI без закреплённого openclaw@<semver>, когда панель новее бинарника; HTTP 200 у health при «залипшем» стриминге из‑за буферизации на reverse proxy. Записанный HowTo снимает дрейф до эскалации.
Матрица: CLI, панель и doctor
| Задача | Сначала CLI | Панель | Doctor |
|---|---|---|---|
| Установка OpenClaw | npm install -g openclaw@<pin>, проверка node -v |
Только справка; пин версии — в npm | openclaw doctor после установки (PATH, миграции) |
| Постоянный шлюз | openclaw onboard --install-daemon → launchd |
Сверить пользователя демона в настройках, если поле есть | Предупреждения прав и каталогов данных |
| Навыки и стриминг | Резервный синхрон из CLI при лаге UI | Каталог, включение, порядок, переключатель стриминга | Блокировки политик до обвинения UI |
| Откат | Предыдущий тег npm, рестарт демона | Отключить проблемный набор, вернуть каталожную версию | Снимок конфига до doctor --fix |
HowTo: шаги по порядку
Публичные гайды начинают с npm install -g openclaw; в продакшене закрепите семвер после QA на ту же линию, что и шлюз v2026.3.24.
node -v npm install -g openclaw@latest # замените на свой pin после регресса openclaw --version
openclaw onboard --install-daemon
Мастер проведёт через провайдеров, порт шлюза, каналы и каркас навыков и поставит фоновый сервис (на macOS — через launchd), чтобы процесс переживал выход из SSH и перезагрузку — в отличие от «голого» openclaw gateway в tmux на арендованном Mac.
openclaw gateway status и глубина
Подтвердите слушатель, версию рантайма и пробы; при поддержке сборки добавьте --deep или --json для машинного артефакта в CI.
openclaw gateway status # при необходимости: # openclaw gateway status --deep # openclaw gateway status --json
Откройте локальный URL панели (часто 127.0.0.1:18789 — наружу только через SSH‑туннель или mTLS). Установите навыки из каталога, назначьте рабочую область, включите стриминг, затем короткий диалог с вызовом инструмента и проверьте, что chunked/SSE не режет прокси. Логику повторов после сбоев можно согласовать с гайдом по восстановлению и retry.
Перед апгрейдом архивируйте ~/.openclaw/ и кастомные каталоги навыков. Откат: предыдущий тег npm → рестарт демона → в панели отключить плохую версию набора. Репетируйте на стендовом хосте MacPull, затем прод.
openclaw doctor — регулярный аудит только на чтение; openclaw doctor --fix — только в окне изменений после бэкапа. Один LaunchAgent/cron объединяет doctor и gateway status, чтобы дежурство получало один pass/fail.
#!/bin/sh set -euo pipefail openclaw doctor openclaw gateway status # опционально после снимка: # openclaw doctor --fix
Что приложить к тикету
- База Node: минимальная мажорная версия и пин OpenClaw.
- Порт панели: loopback vs TLS на краю.
- Стриминг: политика буферизации прокси и idle‑таймауты.
FAQ: частые ошибки
command not found: openclaw после npm
Глобальный bin не в PATH неинтерактивных shell. Выведите npm prefix -g, добавьте bin в PATH в plist или симлинк в /usr/local/bin.
Убедитесь, что использовали --install-daemon и загрузили plist нужным пользователем; GUI‑сессии гасят иные агенты — перенесите на пользовательский/системный агент по модели выдачи MacPull.
Разные домашние каталоги данных: выровняйте OPENCLAW_HOME (или эквивалент) между CLI и plist, снова выполните doctor.
Отключите буферизацию, поднимите таймауты, проверьте curl с потоковыми заголовками; длинные инструменты — частичные токены/heartbeat.
Стабильная ценность арендованного Mac
Выделенный Mac mini M4 даёт предсказуемый NVMe, изоляцию соседей и площадку, где демон OpenClaw, кеш навыков и объединённый контур doctor + gateway status работают круглосуточно. Когда совпадают пин CLI, панель и скрипт автоматизации, обновления перестают быть лотереей — это ровно тот сценарий, ради которого команды берут удалённый Mac под шлюз.
Оформление без обязательного входа для чтения: главная MacPull, цены, покупка, центр помощи и каталог блога.