> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

В этом документе описан **текущий** процесс онбординга при первом запуске. Цель —
плавный опыт «день 0»: выбрать, где работает Gateway (шлюз), подключить аутентификацию,
пройти мастер и позволить агенту самостоятельно выполнить начальную инициализацию.
Для общего обзора сценариев онбординга см. [Onboarding Overview](/start/onboarding-overview).

<Steps>
  <Step title="Approve macOS warning">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=52ce8b835daf7a29b63c3ee7f4a0308a" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Approve find local networks">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=898d91d6350aef17eb26d54f2aae7398" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="Welcome and security notice">
    <Frame caption="Прочитайте отображаемое уведомление о безопасности и примите решение">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=f5c2f45dfb79fb3102f3b00349685c5e" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>
  </Step>

  <Step title="Local vs Remote">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=280e34bced7bf879d9b6f74a77abcda0" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

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

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

    <Tip>
      **Совет по аутентификации Gateway (шлюза):**

      * Мастер теперь генерирует **токен** даже для local loopback, поэтому локальные WS‑клиенты должны проходить аутентификацию.
      * Если отключить аутентификацию, любой локальный процесс сможет подключаться; используйте это только на полностью доверенных машинах.
      * Используйте **токен** для доступа с нескольких машин или для небиндингов не через loopback.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="Выберите, какие разрешения вы хотите предоставить OpenClaw">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=fe49a0e85fad11452f3ee292d78e2415" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

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

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

  <Step title="CLI">
    <Info>
      Этот шаг необязателен
    </Info>

    Приложение может установить глобальный CLI `openclaw` через npm/pnpm, чтобы
    рабочие процессы в терминале и задачи launchd работали сразу «из коробки».
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    После настройки приложение открывает выделенный чат онбординга, чтобы агент мог
    представиться и направить дальнейшие шаги. Это позволяет держать руководство при
    первом запуске отдельно от обычного диалога. [Bootstrapping](/start/bootstrapping)
    для понимания того, что происходит на хосте шлюза Gateway при первом запуске агента.
  </Step>
</Steps>