---
read_when:
    - Проєктування помічника онбордингу для macOS
    - Реалізація налаштування автентифікації або ідентичності
sidebarTitle: 'Onboarding: macOS App'
summary: Початковий процес налаштування OpenClaw (застосунок macOS)
title: Онбординг (застосунок macOS)
x-i18n:
    generated_at: "2026-04-05T18:17:51Z"
    model: gpt-5.4
    provider: openai
    source_hash: a3c5f313a8e5c3a2e68a9488f07c40fcdf75b170dc868c7614565ad9f67755d6
    source_path: start/onboarding.md
    workflow: 15
---

# Онбординг (застосунок macOS)

У цьому документі описано **поточний** процес початкового налаштування. Мета —
забезпечити плавний досвід у “день 0”: вибрати, де працює Gateway, підключити автентифікацію, запустити
майстер і дозволити агенту самостійно виконати початкове налаштування.
Загальний огляд шляхів онбордингу див. у [Огляд онбордингу](/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):** онбординг **не** налаштовує локальну автентифікацію;
  облікові дані мають існувати на хості шлюзу.
- **Налаштувати пізніше:** пропустити налаштування й залишити застосунок неналаштованим.

<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="Чат онбордингу (окрема сесія)">
  Після налаштування застосунок відкриває окрему сесію чату онбордингу, щоб агент міг
  представитися й підказати наступні кроки. Це дозволяє тримати початкові вказівки окремо
  від вашої звичайної розмови. Докладніше про те, що відбувається на хості шлюзу під час першого запуску агента, див. у [Початкове налаштування](/start/bootstrapping).
</Step>
</Steps>
