메인 콘텐츠로 건너뛰기

​
온보딩 (macOS 앱)

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

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

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

Local vs Remote

게이트웨이가 어디에서 실행됩니까?
  • 이 Mac (로컬 전용): 온보딩이 인증을 구성하고 로컬에 자격 증명을 기록할 수 있습니다.
  • 원격 (SSH/Tailnet를 통해): 온보딩은 로컬 인증을 구성하지 않습니다. 자격 증명은 게이트웨이 호스트에 있어야 합니다.
  • 나중에 구성: 설정을 건너뛰고 앱을 미구성 상태로 둡니다.
Gateway 인증 팁:
  • 마법사는 이제 로컬 루프백에도 토큰을 생성하므로 로컬 WS 클라이언트는 인증해야 합니다.
  • 인증을 비활성화하면 모든 로컬 프로세스가 연결될 수 있으니 완전히 신뢰할 수 있는 기계에서만 사용하세요.
  • 여러 기계 접근 또는 비루프백 바인드를 위해 토큰을 사용하세요.
5

Permissions

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

CLI

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

Onboarding Chat (dedicated session)

설정 후, 앱은 전용 온보딩 채팅 세션을 열어 에이전트가 자기소개를 하고 다음 단계를 안내할 수 있게 합니다. 이는 첫 실행 안내를 일반 대화와 분리합니다. 첫 에이전트 실행 시 게이트웨이 호스트에서 무슨 일이 일어나는지에 대한 자세한 내용은 Bootstrapping을 참조하세요.