Онбординг (приложение для macOS)¶

В этом документе описан текущий процесс онбординга при первом запуске. Цель — плавный опыт «день 0»: выбрать, где работает Gateway (шлюз), подключить аутентификацию, пройти мастер и позволить агенту самостоятельно выполнить начальную инициализацию.

Где работает Gateway (шлюз)?

• Этот Mac (только локально): онбординг может выполнять OAuth‑процессы и записывать учётные данные локально.
• Удалённо (через SSH/Tailnet): онбординг не выполняет OAuth локально; учётные данные должны существовать на хосте шлюза Gateway.
• Настроить позже: пропустить настройку и оставить приложение ненастроенным.

Совет по аутентификации Gateway (шлюза): - Мастер теперь генерирует токен даже для local loopback, поэтому локальные WS‑клиенты должны проходить аутентификацию. - Если отключить аутентификацию, любой локальный процесс сможет подключаться; используйте это только на полностью доверенных машинах. - Используйте токен для доступа с нескольких машин или для небиндингов не через loopback.

Онбординг запрашивает разрешения TCC, необходимые для:

• Автоматизации (AppleScript)
• Уведомлений
• Универсального доступа
• Записи экрана
• Микрофона
• Распознавания речи
• Камеры
• Местоположения

Этот шаг необязателен Приложение может установить глобальный CLI openclaw через npm/pnpm, чтобы рабочие процессы в терминале и задачи launchd работали сразу «из коробки». После настройки приложение открывает выделенный чат онбординга, чтобы агент мог представиться и направить дальнейшие шаги. Это позволяет держать руководство при первом запуске отдельно от обычного диалога. Bootstrapping для понимания того, что происходит на хосте шлюза Gateway при первом запуске агента.