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

# 온보딩 (macOS 앱)

# 온보딩 (macOS 앱)

이 문서는 **현재** 첫 실행 온보딩 흐름에 대해 설명합니다. 목표는 매끄러운 "첫날" 경험을 제공하는 것입니다: 게이트웨이 실행 위치를 선택하고, 인증을 연결하고, 마법사를 실행하여 에이전트가 자체 부트스트랩하도록 합니다. 온보딩 경로의 일반 개요는 [Onboarding Overview](/ko-KR/start/onboarding-overview)를 참조하세요.

<Steps>
  <Step title="Approve macOS warning">
    <Frame>
      <img src="https://mintcdn.com/openclaw-kr/hWnB5E43T352G88Z/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=hWnB5E43T352G88Z&q=85&s=7b90b81fad7d38b0dd4b618994170d80" 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/openclaw-kr/hWnB5E43T352G88Z/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=hWnB5E43T352G88Z&q=85&s=8890a7a4a35195df11d7e2c5c5451b66" 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/openclaw-kr/hWnB5E43T352G88Z/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=hWnB5E43T352G88Z&q=85&s=b9b49b603f77c5e84752aed2047adcb0" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>

    보안 신뢰 모델:

    * 기본적으로 OpenClaw는 개인 에이전트입니다: 단일 신뢰 운영자 경계.
    * 공유/다중 사용자 구성은 잠금 구성이 필요합니다 (신뢰 경계 분리, 최소 도구 접근 유지, [보안](/ko-KR/gateway/security) 준수).
    * 로컬 온보딩은 이제 새 구성의 기본값을 `tools.profile: "coding"`으로 설정합니다. 따라서 새 로컬 구성은 무제한 `full` 프로파일을 강제하지 않으면서도 파일시스템/런타임 도구를 유지합니다.
    * hooks/webhooks 또는 기타 비신뢰 콘텐츠 피드를 활성화한다면, 강력한 최신 모델 티어를 사용하고 엄격한 도구 정책/샌드박싱을 유지하세요.
  </Step>

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

    **게이트웨이**가 어디에서 실행됩니까?

    * **이 Mac (로컬 전용):** 온보딩이 인증을 구성하고 로컬에 자격 증명을 기록할 수 있습니다.
    * **원격 (SSH/Tailnet를 통해):** 온보딩은 로컬 인증을 구성하지 않습니다. 자격 증명은 게이트웨이 호스트에 있어야 합니다.
    * **나중에 구성:** 설정을 건너뛰고 앱을 미구성 상태로 둡니다.

    <Tip>
      **Gateway 인증 팁:**

      * 마법사는 이제 로컬 루프백에도 **토큰**을 생성하므로 로컬 WS 클라이언트는 인증해야 합니다.
      * 인증을 비활성화하면 모든 로컬 프로세스가 연결될 수 있으니 완전히 신뢰할 수 있는 기계에서만 사용하세요.
      * 여러 기계 접근 또는 비루프백 바인드를 위해 **토큰**을 사용하세요.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="OpenClaw에 부여할 권한을 선택하세요">
      <img src="https://mintcdn.com/openclaw-kr/hWnB5E43T352G88Z/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=hWnB5E43T352G88Z&q=85&s=5ddf67b32927caba47bc6607c54fceab" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

    온보딩은 TCC 권한을 요청합니다:

    * 자동화 (AppleScript)
    * 알림
    * 접근성
    * 화면 녹화
    * 마이크
    * 음성 인식
    * 카메라
    * 위치
  </Step>

  <Step title="CLI">
    <Info>이 단계는 선택 사항입니다</Info>
    앱은 글로벌 `openclaw` CLI를 npm/pnpm을 통해 설치할 수 있어 터미널 워크플로우와 launchd 작업이 즉시 작동합니다.
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    설정 후, 앱은 전용 온보딩 채팅 세션을 열어 에이전트가 자기소개를 하고 다음 단계를 안내할 수 있게 합니다. 이는 첫 실행 안내를 일반 대화와 분리합니다. 첫 에이전트 실행 시 게이트웨이 호스트에서 무슨 일이 일어나는지에 대한 자세한 내용은 [Bootstrapping](/ko-KR/start/bootstrapping)을 참조하세요.
  </Step>
</Steps>