메인 콘텐츠로 건너뛰기

​
온보딩 (macOS 앱)

이 문서는 현재의 최초 실행 온보딩 흐름을 설명합니다. 목표는 매끄러운 ‘day 0’ 경험입니다. 즉, Gateway(게이트웨이)가 실행될 위치를 선택하고, 인증을 연결하며, 마법사를 실행하고, 에이전트가 스스로 부트스트랩하도록 하는 것입니다. 온보딩 경로에 대한 전반적인 개요는 Onboarding Overview를 참조하세요.
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

Gateway(게이트웨이) 는 어디에서 실행됩니까?
  • 이 Mac (로컬 전용): 온보딩에서 OAuth 플로우를 실행하고 자격 증명을 로컬에 기록할 수 있습니다.
  • 원격 (SSH/Tailnet 경유): 온보딩에서 로컬로 OAuth 를 실행하지 않습니다. 자격 증명은 게이트웨이 호스트에 이미 존재해야 합니다.
  • 나중에 구성: 설정을 건너뛰고 앱을 미구성 상태로 둡니다.
Gateway(게이트웨이) 인증 팁:
  • 이제 마법사는 loopback 에 대해서도 토큰을 생성하므로, 로컬 WS 클라이언트는 반드시 인증해야 합니다.
  • 인증을 비활성화하면 어떤 로컬 프로세스든 연결할 수 있습니다. 완전히 신뢰된 머신에서만 사용하십시오.
  • 다중 머신 접근 또는 non‑loopback 바인딩에는 토큰을 사용하십시오.
5

Permissions

온보딩은 다음에 필요한 TCC 권한을 요청합니다:
  • 자동화 (AppleScript)
  • 알림
  • 접근성
  • 화면 기록
  • 마이크
  • 음성 인식
  • 카메라
  • 위치
6

CLI

이 단계는 선택 사항입니다
앱은 npm/pnpm 을 통해 전역 openclaw CLI 를 설치할 수 있으므로, 터미널 워크플로와 launchd 작업이 즉시 동작합니다.
7

Onboarding Chat (dedicated session)

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