---
read_when:
    - Проєктування помічника онбордингу для macOS
    - Реалізація налаштування автентифікації або ідентичності
sidebarTitle: 'Onboarding: macOS App'
summary: Процес налаштування під час першого запуску для OpenClaw (застосунок macOS)
title: Адаптація (застосунок macOS)
x-i18n:
    generated_at: "2026-06-27T18:21:43Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 73f902bcbb7ef782d4a5fbe442a8855a8fcb426d45167c4d2fc1fc050263b5f1
    source_path: start/onboarding.md
    workflow: 16
---

Цей документ описує **поточний** процес налаштування під час першого запуску. Мета — забезпечити
плавний досвід "дня 0": вибрати, де працює Gateway, підключити автентифікацію, запустити
майстер і дозволити агенту самостійно ініціалізуватися.
Загальний огляд шляхів онбордингу див. у [Огляд онбордингу](/uk/start/onboarding-overview).

<Steps>
<Step title="Підтвердьте попередження macOS">
<Frame>
<img src="/assets/macos-onboarding/01-macos-warning.jpeg" alt="" />
</Frame>
</Step>
<Step title="Підтвердьте пошук локальних мереж">
<Frame>
<img src="/assets/macos-onboarding/02-local-networks.jpeg" alt="" />
</Frame>
</Step>
<Step title="Привітання та повідомлення про безпеку">
<Frame caption="Прочитайте показане повідомлення про безпеку й ухваліть відповідне рішення">
<img src="/assets/macos-onboarding/03-security-notice.png" alt="" />
</Frame>

Модель довіри безпеки:

- За замовчуванням OpenClaw — це персональний агент: одна довірена межа оператора.
- Спільні/багатокористувацькі налаштування потребують жорсткого обмеження (розділіть межі довіри, мінімізуйте доступ до інструментів і дотримуйтеся розділу [Безпека](/uk/gateway/security)).
- Локальний онбординг тепер за замовчуванням встановлює для нових конфігурацій `tools.profile: "coding"`, щоб нові локальні налаштування зберігали інструменти файлової системи/середовища виконання без примусового використання необмеженого профілю `full`.
- Якщо ввімкнено hooks/webhooks або інші канали недовіреного вмісту, використовуйте сильний сучасний рівень моделі та підтримуйте сувору політику інструментів/пісочниці.

</Step>
<Step title="Локально чи віддалено">
<Frame>
<img src="/assets/macos-onboarding/04-choose-gateway.png" alt="" />
</Frame>

Де працює **Gateway**?

- **Цей Mac (лише локально):** онбординг може налаштувати автентифікацію та записати облікові дані
  локально.
- **Віддалено (через SSH/Tailnet):** онбординг **не** налаштовує локальну автентифікацію;
  облікові дані мають існувати на хості Gateway. Поле токена віддаленого Gateway
  зберігає токен, який macOS-застосунок використовує для підключення до цього Gateway; наявні
  не відкритотекстові значення `gateway.remote.token` зберігаються, доки ви їх не заміните.
- **Налаштувати пізніше:** пропустити налаштування й залишити застосунок неналаштованим.

<Tip>
**Порада щодо автентифікації Gateway:**

- Майстер тепер генерує **токен** навіть для loopback, тому локальні WS-клієнти мають автентифікуватися.
- Якщо вимкнути автентифікацію, будь-який локальний процес зможе підключитися; використовуйте це лише на повністю довірених машинах.
- Використовуйте **токен** для доступу з кількох машин або прив’язок не до loopback.

</Tip>
</Step>
<Step title="Дозволи">
<Frame caption="Виберіть, які дозволи ви хочете надати OpenClaw">
<img src="/assets/macos-onboarding/05-permissions.png" alt="" />
</Frame>

Онбординг запитує дозволи TCC, потрібні для:

- Автоматизації (AppleScript)
- Сповіщень
- Доступності
- Запису екрана
- Мікрофона
- Розпізнавання мовлення
- Камери
- Місцезнаходження

</Step>
<Step title="CLI">
  <Info>Цей крок необов’язковий</Info>
  Застосунок може встановити глобальний CLI `openclaw` через npm, pnpm або bun.
  Спершу він віддає перевагу npm, потім pnpm, а потім bun, якщо це єдиний виявлений
  менеджер пакетів. Для середовища виконання Gateway рекомендованим шляхом залишається Node.
</Step>
<Step title="Онбординг-чат (окремий сеанс)">
  Після налаштування застосунок відкриває окремий сеанс онбординг-чату, щоб агент міг
  представитися й підказати наступні кроки. Це відокремлює підказки першого запуску
  від вашої звичайної розмови. Див. [Ініціалізація](/uk/start/bootstrapping), щоб дізнатися,
  що відбувається на хості Gateway під час першого запуску агента.
</Step>
</Steps>

## Пов’язане

- [Огляд онбордингу](/uk/start/onboarding-overview)
- [Початок роботи](/uk/start/getting-started)