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

# Первичная настройка (приложение для macOS)

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

<Steps>
  <Step title="Подтвердите предупреждение macOS">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=7ade99ff85eba6a2fe743ff1f7799087" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Разрешите поиск локальных сетей">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=e9fcec535d0cdca207cff0cf2379e951" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

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

    Модель доверия безопасности:

    * По умолчанию OpenClaw является персональным агентом: одна граница доверенного оператора.
    * Общие/многопользовательские конфигурации требуют усиленной защиты (разделяйте границы доверия, минимизируйте доступ к инструментам и следуйте разделу [Безопасность](/ru/gateway/security)).
    * Локальный онбординг теперь по умолчанию задает в новых конфигурациях `tools.profile: "coding"`, чтобы свежие локальные настройки сохраняли инструменты файловой системы/среды выполнения без принудительного включения неограниченного профиля `full`.
    * Если включены hooks/webhooks или другие каналы непроверенного содержимого, используйте сильный современный уровень модели и сохраняйте строгую политику инструментов/песочницы.
  </Step>

  <Step title="Локально или удаленно">
    <Frame>
      <img src="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=7e923f389e6d774363064140691b4fbe" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </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="https://mintcdn.com/clawdhub/zr61AlCx-k7XN8so/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=zr61AlCx-k7XN8so&q=85&s=6c45fa49282cf491a1425a714ec68f18" 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 или bun.
    Сначала оно предпочитает npm, затем pnpm, затем bun, если это единственный обнаруженный
    менеджер пакетов. Для среды выполнения Gateway рекомендуемым путем остается Node.
  </Step>

  <Step title="Онбординг-чат (выделенный сеанс)">
    После настройки приложение открывает выделенный сеанс онбординг-чата, чтобы агент мог
    представиться и подсказать дальнейшие шаги. Это отделяет руководство при первом запуске
    от обычного разговора. См. [Начальная инициализация](/ru/start/bootstrapping), чтобы узнать,
    что происходит на хосте Gateway во время первого запуска агента.
  </Step>
</Steps>

## Связанные материалы

* [Обзор онбординга](/ru/start/onboarding-overview)
* [Начало работы](/ru/start/getting-started)