> ## 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 앱)

이 문서는 **현재**의 최초 실행 온보딩 흐름을 설명합니다. 목표는 매끄러운 'day 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 를 실행하지 **않습니다**. 자격 증명은 게이트웨이 호스트에 이미 존재해야 합니다.
    * **나중에 구성:** 설정을 건너뛰고 앱을 미구성 상태로 둡니다.

    <Tip>
      **Gateway(게이트웨이) 인증 팁:**

      * 이제 마법사는 loopback 에 대해서도 **토큰**을 생성하므로, 로컬 WS 클라이언트는 반드시 인증해야 합니다.
      * 인증을 비활성화하면 어떤 로컬 프로세스든 연결할 수 있습니다. 완전히 신뢰된 머신에서만 사용하십시오.
      * 다중 머신 접근 또는 non‑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>

    앱은 npm/pnpm 을 통해 전역 `openclaw` CLI 를 설치할 수 있으므로, 터미널 워크플로와 launchd 작업이 즉시 동작합니다.
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    설정이 완료되면 앱은 전용 온보딩 채팅 세션을 열어 에이전트가 자신을 소개하고 다음 단계를 안내하도록 합니다. 이는 최초 실행 가이드를 일반 대화와 분리합니다. 첫 번째 에이전트 실행 동안 게이트웨이 호스트에서 발생하는 작업에 대해서는 [Bootstrapping](/start/bootstrapping)을 참고하십시오.
  </Step>
</Steps>